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B/P BIOS 


INTRODUCTION 


1.0 Introduction. 

The Banked and Portable (B/P) Basic I/O System (BIOS) is an effort to stan- 
dardize many of the logical to physical mapping mechanisms on Microcomputers 
running Z- Systems with ZSDOS. In expanding the capabilities of such systems, 
it became apparent that standard BIOSes do not contain the functionality 
necessary, adequate standardization in extended BIOS calls, nor an internal 
structure to fully support external determination of system parameters. B/P 
Bios provides a method of achieving these goals, while also possessing the 
flexibility to operate on a wide range of hardware systems with a much smaller 
level of systems programming than previously required. 


1.1 About This Manual. 

Documentation on B/P Bios consists of this manual plus the latest addendum on 
the distribution disk in the file README. 2ND. This manual is divided into the 
following sections: 

o The Features of B/P Bios summarizes the significant features of B/P 
Bios in general, highlighting advantages and the few limitations 
in the system. 

o Tailoring B/P Bios contains details on altering the many options to 
generate a customized .RTL file tailored to your system. 

c Installing a B/P Bios details the installation of B/P Bios in both 
L’nbankeJ and Dunked configurations in a "how to" fashion. 

o Programming for B/P Bios describes the interfaces, data structure 1 , 
and recommended programming practices to insure the maximum 
benefit and performance from systems with B/P Bios. 

o The B/P Bios Utilities describes the purpose, operation, and custom- 
ization of all supplied B/P Bios utilities and support routines. 

o Appendices which summarize various technical information. 

o A glossary def ini ng many technical terms used in this Manual. 

o An index of key words and phrases used in this Manual. 

For those not interested in the technical details, or who want to bring the 
system up with a pre-conf igured version as quickly as possible. Section 4. 
Installing a B/P Bios, will lead you through the installation steps needed to 
perform the final tailoring to your specific computer. Other chapters cover 
details of the individual software modules comprising the B/P Bios, and spe- 
cifics on the utilities provided to ease you use of this product. 
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1.2 Notational Conventions 

Various shorthand terms and notations are used throughout this manual. Terms 
are listed in the Glossary at the end of this manual. 

Though the symbols seem cryptic at first, they are a consistent way of briefly 
summarizing program syntax. Once you learn to read them you can tell at a 
glance how to enter even the most complicated commands. 

Several special symbols are used in program syntax descriptions. By conven- 
tion, square brackets ([]) indicate optional command line items. You may or 
may not include items shown between brackets in your command, but if you do 
not, programs usually substitute a default value of their own. If items 
between brackets are used in a command, all other items between the brackets 
must also be used, unless these items are themselves bracketed. 

All of the support utilities developed to support the B/P Bios system contain 
built-in help screens which use the above conventions to display helpful 
syntax summaries. Help is always invoked by following the command w'ith two 
slashes (//). So for example. 

ZXD // 

invokes help for ZXD. the ZSDOS extended directory program. Interactive ZSDOS 
programs such as BPCNFG2 also contain more detailed help messages which appear 
as a session progresses. 

Many utilities may be invoked from the command line with options which command 
the programs to behave in slightly different ways. By convention, options are- 
given after other command parameters. For example, the P option in the com- 
mand 

ZXD *.* P 


causes the ZXD directory utility to list all files (*.*) and send its output 
to the printer (P). For convenience, a single slash character (/) can often 
be used in place of leading parameters to signify that the rest of the command 
line consists of option characters. Therefore, the command 

ZXD /P 

is identical in meaning to the previous example (see 6.23 for more on ZXD). 


1.3 What is B/P Bios? 

B/P Bios is a set of software subroutines which directly control the chips and 
other hardware in y^our computer and present a standard software interface to 
the Operating System such as our ZSDOS/ZDDOS, Echelon's ZRDOS, or even Digital 
Research's CP/M 2.2. These routines comply' with the CP/M 2.2 standards for a 
Basic 10 System (BIOS) with many extensions; some based on CP/M 3.x (aka CP/M 
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Plus), and others developed to provide necessary capabilities of modern soft- 
ware. When properly coded, the modules comprising a B/P Bios perform with all 
the standard support utilities, nearly all Z-System utilities, and most appli- 
cation programs without alteration. 

The ability to operate Banked, Non-banked and Boot System versions of the Bios 
with a single suite of software, across a number of different hardware ma- 
chines, plus the maximization of Transient Program Area for application pro- 
grams in banked systems are features which are offered by no other system of 
which we are aware. 


1.3 The History of B/P Bios. 

Our earlier work developing ZSDOS convinced us that we needed to attack the 
machine-dependent software in ZSO-compat ible computers and develop some stan- 
dard enhancements in order to exercise the full potential of our machines. 
This premise is even more true today with large Hard Disks (over 100 Mega- 
bytes) being very common, needs for large RAM Drives, and an ever shrinking 
Transient Program Area. Attempts to gain flexibility with normal operating 
systems were constrained by the 64k addressable memory range in ZSO-compatible 
systems, and forced frequent operating system changes exemplified by NZCOM and 
NZBLITZ where different operating conf igurat ions could be quickly changed to 
accommodate application program needs. 

In the mid to late 1 980 ' s , several efforts had been made to bank portions of 
CP/M 2.2 "type" systems. XBIOS was a banked Bios for only the HD64 180-based 
MicroMint SB- ISO family. While it displayed an excellent and flexible inter- 
face and the ability to operate with a variety of peripherals, it had several 
quirks and noticeably degraded the computer performance. A banked Bios was 
also produced for the XLM-180 single board S-100 computer, but required spe- 
cial versions of many Z-System utilities, and was not produced in any signifi- 
cant quantity. Other spinoffs, such as the Epson portable, attempted banking 
of the Bios, but most failed to achieve our comprehensive goals of compatibil- 
ity with the existing software base, high performance, and portability. 

In 1989. Cam developed the first prototype of B/P Bios in a Non-banked mode on 
his TeleTtk while Hal concentrated on extending ZSDOS and the Command Proces- 
sor. As of mid- 1992, B/P Bios has been installed on: 


YASBEC - 

Ampro LB w/MDISK - 
MicroMint SB-180 - 
Compu/Time S-100 - 
Teletek - 


Z180 CPU, FD1”" 7 2 FDC . DP8490 SCSI, 1MB RAM 
ZSO CPU, FD1770 FDC, MDISK 1MB RAM 
HD64180 CPU, SMS9266 FDC, 256KB RAM 
ZSO CPU, FD1795 FDC, 1 MB RAM 
ZSO CPU, NEC? 65 FDC. 64KB RAM 


3 


FEATURES 


B/P BIOS 


2 Features of B/P Bios. 

B/P BIOS is designed to be completely compatible with the CP/M 2.2 standards 
for a Basic 10 System, as well as to provide many extensions needed for banked 
memory which is becoming so prevalent with newer systems and processors. 
Additionally, strict coding standards used in the various modules forming the 
BIOS ease interface problems with applications programs and provide a more 
robust framework for future development. The extensions added to the basic 
CP/M 2.2 foundation include many elements from Digital Research's CP/M 3 (aka 
CP/M Plus), but in a more logically consistent manner. Also included in 
banked versions are provisions for managing up to 8 MB of extended memory for 
banked applications, RAM Drives and potentially multitasking in future ver- 
sions. To provide insight into the methodology used, let us now examine some 
of the features in a generic B/P Bios. 


2.1 Character 10. 

As defined by Digital Research, in their CP/M 2.2 standards, character 10 
consisted of logical devices referred to as TTY, CRT. UC1 , CON, etc. B/P Bios 
extends and generalizes these interfaces using the IOBYTE to define four 
physical devices called COM2, COM2. P10 and NIT., The first two. COM. I and 
COM2, are serial ports: PIO is a Parallel port, while NUL is a "bit-bucket" 
which can be replaced by a customized driver, or used in lieu of an actual 
device. Digital Research provided only a limited interface capability to tile 
character devices in CP/M 2.2. consisting of a Console (CON), an auxiliary 
Input and Output (RDR/PUN), and a Printer (LST). The ability to sense Input 
and Output Status with these devices was extremely limited and was enhanced in 
CP/M 3. These enhanced capabilities are completely incorporated into B/P Bios 
with the addition of strict register usage so that only relevant registers may 
be altered in the respective routines. By manipulating the IOBYTE, any of the 
four physical devices may be used in the three logical devices of CONsole. 
Auxiliary, and Printer (LST). 

Also featured in B/P Bios are modifications of CP/M 3 functions to initialize 
(or re-ini t ial ize ) all devices and parameters, and return the address of a 
table which contains names and parameters of the defined character devices. 
While not totally compatible with C'P/M 3 equivalents, these functions are 
consistent with the spirit and functionality needed with this advanced system. 
Included in the device table are: flags defining whether the device is capable 
of Input. Output or Both, Data rates for serial devices (Maximum and Set), 
Serial data format where applicable, and Handshaking method (CTS/RTS, XON/XOFF 
or None), as well as Input and Output Data masks for stripping unneeded bits 
from characters during 10. 


2.2 Mass Storage 10. 

All versions of Digital Research's CP/M BIOSes define only a generic Disk 
driver with implementations of Floppy, Hard, RAM and Tape drives left to the 
user or developer. In B/P Bios, we went several steps further to ease many 
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problems. First, we retained all standard CP/M 2.2 functions and parameters, 
added CP/M 3 features for returning the Disk Parameter Header (DPH) table 
address, and flushing of the software deblocking code segment, and added a new 
vector to the BIOS jump table to provide a standard method of directly ad- 
dressing low-level device functions. Several standard low-level Floppy Disk 
functions are supported and used by the standard utilities, including a func- 
tion to return the type of Disk Controller in use which permits a single 
support utility to adapt to a wide variety of hardware platforms. In a like 
manner, low-level functions are provided for SCSI/SAS1 Hard Disk drives, and 
provisions for RAM Disk drives in the event special hardware is implemented. 
The methods used to implement these access mechanisms may be logically extend- 
ed to handle Tape Drives or Network Interfaces. 


2.3 Clock Support for Time and Date. 

Many Hardware vendors have added provisions for Time and Date as non-standard 
extensions to CP/M 2.2 BIOSes, and more have incorporated such support into 
CP/M 3 BIOSes. We opted to define the CP/M 3 clock vector as a ZSDOS-standard 
clock building on our previous Operating System work. This entry point into 
the Bios completely complies with our ZSDOS standards and can completely 
replace the separate clock driver when used with ZSDOS. For systems capable 
of returning tenths-of -seconds . such as the YASBEC and SB-1S0. the standard 
has been enhanced to support this capability as well. 


2.4 Banked Memory Support. 

While Digital Research adder banked memory support to their CP/M 3. it was in 
a manner incompatible with Bios interface standards defined for earlier CP/M 
standards. The method used in B/P Bios is compliant with CP/M 2.2 in direct 
accessing oi Bios functions with only one minor exception when using the 
Banked ZSD0S2. and contains many of the CP/M 3 extensions added for banked 
memory support, with some being modified to be consistent with standards 
adopted for Z-Svstem software. The exception to CP/M 2.2 accesses occurs when 
the Operating System can access certain buffers in the System Memory Bank. 
With ZSDOS 2. Al locat ion Bit Buffers (AI.Y), Check Buffers ( CSV ) . and the Disk 
Host Buffer are all contained in the System Bank and not directly accessible 
from Transient Programs. To compensate for this, we have added a command to 
ZSDOS 2 to return the free space on disks (the most common reason for access- 
ing these buffers) and tailored several utilities to adapt to banked and non- 
banked systems. 

In addition to the primitives initiated by Digital Research, we added func- 
tions to directly access Words and Bytes in extended banks of memory, Directly 
accessing software routines contained in alternate memory banks, and proper]} 
managing the system when errors occur. These features make B/P Bios much more 
robust and resilient than other products. These features are implemented by 
methods transparent to the system utilities so that the same functions are 
available in both banked and non-banked versions. 
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2.5 Other Features. 

B/P Bios contains a standardized identification method which may be used to 
determine the hardware on which the software is operating. This allows appli- 
cations to "adapt” to the environment in a manner similar to that used in the 
rest of the Z-System community. It also minimizes system "crashes" by execut- 
ing programs which assume certain hardware features which may be detrimental 
if executed on other systems. The effects of identification of physical 
system parameters is most readily noticed by virtue of a single suite of 
support programs performing low-level functions such as formatting and diag- 
nostics w'hich function across widely differing hardware platforms. Portabili- 
ty on this scale can rarely be seen in other computer systems. 

The ZCPR 3.4 Environment with extensions is mandatory in a B/P Bios system. 
Beginning with the addition of System Segment address and size information for 
CPR, DOS and BIOS which w^ere added in the ZCPR 3.4 Environment. B/P Bios also 
adds a Resident User Space which may be used to locate unique routines for 
custom applications in a manner similar to. but more consistent than NZ-COM. 
An Environment Version number of 90H identifies the Z3 Environment as being 
compliant with, B/P definitions. 

In Banked systems, application programs may also be placed in alternate memory 
banks using location and sizing information contained at standard positions 
within the Bios Header Structure. This leature permits significantly greater 
functionality without sacrificing precious Transient Program Area. While the 
scheme employed in the initial distribution is subject to minor adjustments as 
the banked ZSD0S2 becomes more firmly developed, experimentation and sugges- 
tions into tins realm are encouraged. 
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3. Tailoring a B/P Bios. 

To customize a B/P Bios for your use, or adapt it to a new hardware set, you 
will need an editor and an assembler capable of producing standard Microsoft 
Relocatable files. Systems using the Hitachi HD64180 or Zilog ZiSO must be 
assembled with either ZMAC or SLR180 which recognize the extended mnemonic 
set, or with a Z80 assembler and MACRO file which permits assembly of the 
extended instructions. For Z80 and compatible processors, suitable assemblers 
include ZMAC and Z80ASM. For any assembler, failure to produce standard 
Microsoft Relocatable code will preclude the ability of our Standard utilities 
to properly install B/P Bios systems. 


3.1 Theory of Operation. 


In order to understand the need for, and principles behind B/P Bios, you must 
understand the way in which CP/M 2.2, as modified by the Z-System. uses t lie 
available memory address space of a Z80 microprocessor. For standard versions 
of CP/M and compatible systems, the only absolute memory addresses are con- 
tained in the Base Page which is the range of 0 to 100H. All addresses above 
this point are variable (within certain limits). User programs are normally 
run from the Transient Program Area (TPA) which is the remaining space after 
all Operating System components have been allocated. The following depicts 
the assigned areas pictorial ly along with some common elements assigned to 
each memory area: 


FFF P H 


/-System Buffers 


Bios 


0100H 

0000H 


Operating System 
Command Processor 
Transient 
Program 
Area 

Base Page 


ENV, TCAP, IOP, FCP , RC.P 
Code + ALV, CSV, Sector Buffers 
CP/M 2.2, ZRDOS, ZSDGS1 
CCP, ZCPR3.X 


IOBYTE, Jmp WB, Jmp Dos, FCB, Buffer 


As more and more functionality was added to the Z-System Buffers, bigger 
drives were added using more ALV space, and additional functionality was added 
to Bios code in recent systems, the available TPA space has become increasing- 
ly scarce. 

B/P Bios attacks this problem at the source in a manner which is easily adapt- 
able to different hardware platforms. It uses additional memory for more than 
the traditional role of simple RAM Disks, it moves much of the added overhead 
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to alternate memory banks. The generic scheme appears pictorial iy as: 


FFFFH 


8000H 


0000H 



TPA SYSTEM 


USER 


RAM DISK 


As can be seen from the above diagram, multiple banks of memory may be as- 
signed to different functional regions of memory, with each 32k bank (except 
for the one defined as BNK1 ) being switched in and out of the lower 32k of the 
processor’s memory map. The bank defined as BNK1 is ALWAYS present and is 
referred to as the Common Bank. This bank holds the portions of the Operating 
System (Command Processor. Operating System, BIOS, and Z-System tables) which 
may be accessed from other areas, and which therefore must always be "visible" 
in the processor's memory. It also contains the code to control the Bank 
switching mechanisms within the B/P Bios. 

To illustrate this functional division, the memory map of a basic B/P Bios 
system is divided as: 


FFFFH 


Z-System Buffers 


User Space 


0100H 

0000H 


Bios 


Operating System 


Command Processor 


8000H b Transient 


Program 


Area 


Base Page 


TPA (BNK0/BNK1 ) 


Bios Buffers 
Banked Bios Part 


Banked Dos Part 


Banked CCP Part 


CCP Restoral 


Base Page Copy 


System Bank (BNK2) 


8000H 


0100H 

0000H 


8 










B/P BIOS 


TAILORING 


The B/P Bios banking concept defines a one byte Bank Number permitting up to 8 
Megabytes to be directly controlled. Certain assumptions are made in the 
numbering scheme, the foremost of which is that BNKO is the lowest physical 
RAM bank, BNKJ is the next incremental RAM bank, with others follow in incre- 
menting sequential order. A couple of examples may serve to illustrate this 
process. The YASBEC is offered with a couple of options in the Memory Map. 
Units with the MEM- 1 , 2 or 3 decoder PALs assign the first 128k bytes of 
physical memory to the Boot ROM, so BNKO is set to 4 (Banks 0-3 are the ROM). 
The MEM-4 PAL only uses the first 32k (Physical Bank 0) for the ROM which 
means that BNKO is assigned to 1, BNK1 to 2 and so on up to the 1 Megabyte 
maximum where BNKM is 31. 


The Ampro Little Board equipped with MDISK, on the other hand, completely 
removes the Boot ROM from the memory map leaving a maximum of 1 MB of contigu- 
ous RAM space. In this system, BNKO is set to 0 and BNKM to 31 of a fully 
equipped 1 MB MDISK board. 

The region beginning after BNK1 is referred to as the System Bank. It begins 
at the bank number assigned to BNK2 and ends at the bank number immediately 
before that assigned to the User Bank, BXKU if present, or BNK3 if no User 
Bank area is defined. 

If present, one or more 32k banks of memory may be defined with the BNKT 
equate for unique user programs or storage areas. This area begins with the 
bank number set to the label and ends at the bank number immediately before 
the BNK3 label. BNK3 defines a high area of physical memory which is most 
often used for a RAM Disk providing fast temporary workspace in the form of an 
emulated disk drive. 


B/P Bios contains protection mechanisms in the form of software checks to 
insure that critical portions of the memory map are enforced. In the case of 
Non-banked systems, a check is made to insure that the system size is not so 
great that the Bios ma> overwrite reserved Z-System areas in high memory (RCP. 
I OP, etc). If a possible overflow condition is detected, the message 

++ mem ovfl ++ 


will be issued when the system is started. In Banked Bios systems, this 
message will be displayed if the top of the system portions in the SYStem Bank 
exceeds the 32k bank size. For most systems, this space still permits drives 
of several hundred megabytes to be accommodated. 


Since the Common portions of the operating system components must remain 
visible to applications, a similar check is made to insure that the lowest 
address used by the Command Processor is equal to or greater than 8000H. This 
factor is checked both in both MOVxSYS and BPBUILD with either a warnin 
issued in the case of the former, or validity checks on entry in the case oi 
the latter. 
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3.2 B/P Bios Files. 


This BIOS is divided into a number of files, some of which depend highly on 
the specific hardware used on the computer, and some of which are generic and 
need not be edited to assemble a working system. Much use is made of condi- 
tional assembly to tailor the resulting Bios file to the desired configura- 
tion. The Basic file, BPBIO-xx.ZSO, specifies which files are used to assem- 
ble the Bios image under the direction of an included file, DEF-xx.LIB. It is 
this file which selects features and contains the Hardware-dependent mnemonic 
equates. By maintaining the maximum possible code in common modules which 
require no alterations, versions of B/P Bios are relatively easy to convert to 
different machines. The independent modules used in the B/P Bios system are: 


BOOTRAM. Z80 
B00TR0M. Z80 
BYTEIO.Z80 
DEBLOCK. Z80 
DPB.LIB 
DPB8.LIB 
DPB2.LIB 
DPBRAM.LIB 
DPH.LIB 
FLOPPY . Z80 
SECTRAN. Z80 
SELFLP1 . Z80 
SELFLP2 . Z80 
SELRWD . Z80 
Z3BASE.LIB 


- (only needed in BOOT ROM applications) 

- (only needed in BOOT ROM applications) 

- Character 10 per IOBYTE using IIO-xx routines 

- Disk Deblocking routines 

- 3.5/5.25" Floppy Format Definitions (if AutoSelect) 

- 8"/Hi-Density Floppy Format Definitions (if AutoSelect) 

- Additional Floppy Definitions (optional if AutoSelect) 

- Fixed Floppy Format Definitions (if Not AutoSelect) 

- Disk Parameter Header Table Floppy definitions 

- Floppy Disk High-Level Control 

- Sector Translate routines 

- Floppy Select routine (if Not auto selecting) 

- Floppy Select routine (if auto selecting) 

- Generic Read/Write routines 

- ZCPR 3.x file equate for Environment settings 


Other files are hardware version dependent to varying extents. These modules 
requiring customization for different hardware systems are given names which 
end with a generic "-xx" designator to identify specific versions. Tailoring 
these modules ranges from simple prompt line customization to complete re- 
writes. Versions of B/P Bios generated to date are identified as: 


"-18" - MicroMint SB- ISO 

"-YS" - YASBEC 

"-AM" - Ampro Little Board 

"-CT" - Compu/Time S-100 board set 

"-TT" - Teletek 


( 64 ISO CPE, 926b FDC , 53S0 SCSI) 
(Z1S0 CPU, r"2 FDC, DPS 4 90 SCSI) 
(ZSO CPU, P70 FDC, 1MB MDISK) 
(ZSO CPU. 1795 FDC, 1MB Memory) 
(ZSO CPU, 765 FDC) 


Files associated with specific hardware versions or require tailoring are: 


BPBIO-xx . Z80 
CBOOT-xx . Z80 
DEF-xx.LIB 
DPBHD-xx.LIB 
DPBM-xx.LIB 
DPHHD-xx .LIB 
DPHM-xx .LIB 
FDC-xx . ZSO 
HARD-xx . Z80 


Basic file, tailored for included file names 

Cold Boot routines, Sign-on prompts 

Equates for option settings, mode, speed, etc. 

Hard Drive Partition Definitions (optional) 

Ram Drive Definition (optional) 

Hard Drive DPH definitions (optional) 

Ram Drive DPH Definition (optional) 

Floppy Disk Low-Level interface/dr iver routines 

Hard Drive Low-Level interface/dr iver routines (optional) 
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IBMV-xx . Z80 
ICFG-xx . Z80 
IIO-XX.Z80 
RAMD-xx . Z80 
TIM-XX.Z80 
WBOOT-xx . Z80 


Banking Support Routines (if banked) 

Configuration file for speed, Physical Disks, etc 
Character 10 definitions and routines 
Ram Drive interface/dr iver routines (optional) 
Counter/Timer routines and ZSDOS Clock Driver 
Warm Boot and re- in it ial izat ion routines 


3.3 B/P Bios Options. 

The most logical starting point in beginning a conf igurat ion is to edit the 
DEF-xx.LIB file to select your desired options. This file is the basic guide 
to choosing the options for your system, and some careful choices here will 
minimize the Bios size and maximize your functionality. Some of the more 
important options and a brief description of them are: 

MOVCPM - Integrate into MOVCPM "type” loader? If the system is to be in- 
tegrated into a MOVCPM system, the Environment descriptor contained in the 
CBOOT routine is always moved into position as part of the Cold Start process. 
If set to NO. a check will be made to see if an Environment Descriptor is 
already loaded, and the Bios copy will not be loaded if one is present. 

NOTE: When assembling a Bios for Boot Track Installation (MOVCPM set to YEs ! . 
many options are deleted to conserve space and the Bios Version Number is 
forced to 1.1. 

BANKED - Is this a banked BIOS? If set to YES. the Bank control module. IBMV. 
is included in the assembly, and much of the code is relocated o the system 
bank . Note that a Banked system CANNOT be placed on the System Tracks, or 
integrated into a MOVCPM image. 

IBMOVS - Are Direct Inter-Bank Moves possible? If set to YES, direct transfer 
of data between banks is possible such as with the Zilog Z1 SO/Hitachi 64180. 
If NO. a 256-byte transfer buffer is included in high Common Memory and Intel - 
bank moves require transfer of bytes through this buffer. 

ZSD0S2 - Assemble this for a Banked ZSD0S2 system? If YES. the ALV and CSV 
buffers will be placed in the System bank invisible to normal programs. This 
has the side effect that many CP/M programs which perform sizing of files 
(Directory Listers, DATSWEEP, MEX, etc) which do not know about this function 
will report erroneous sizes. The advantage is that no sacrifice in TPA is 
required for large Hard Disks. Set this to NO if you want strict CP/M 2.2 
compat ibi 1 i t y . 

FASTWB - Restore the Command Processor from the System Bank RAM? If set to 
YES. Warm Boots will restore the Command Processor from a reserved area in the 
System RAM bank rather than from the boot tracks. For the maximum benefit of 
B/P Bios, always attempt to set this to YES. In systems without extended 
memory, it MUST be set to NO. 

MHZ - Set to Processor Speed in closest even Megahertz (e.g. for a 9.216 MU:: 
clock rate, set to 9). The value entered here is used in many systems to 
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compute Timing values and/or serial data rate parameters. 

CALCSK - Calculate Diskette Skew Table? If NO. a Skew table is used for each 
floppy format included in the image. Calculating Skew is generally more- 
efficient from a size perspective, although slightly slower by factors which 
are so small as to be practically unmeasurable. 

HAVIOP - Include IOP code into Jump table? If the IOPINIT routine satisfies 
your IOP initialization requirements, you may turn this off by setting to NO 
and save a little space. This typically will be turned off when generating a 
system for MOVCPM integration to conserve space. 

INROM - Is the Alternate Bank in ROM? Set to NO for Normal Disk-based sys- 
tems. Please contact the authors if you need additional information concern- 
ing ROM-based system components. 

BIOERM - Print BIOS error messages? Set this to YES if you desire direct BIOS 
printing of Floppy Disk Error Messages. If you are building a BIOS for place- 
ment on Boot Tracks, however, you will probably not have room and must turn 
this Off. Set to NO to simply return the normal Success/Fail error flag with 
no Message printout. 

FL0PY8 - Include S‘"/Hi-Density Floppy Formats'.' Some systems (SB-180. 
Compu/Time) can handle both 5.25” ana S” disks. If your hardware supports the 
capability and you want use 8" disks as well as the normal 3.5 and 5.25” 
diskettes, setting this to YES will add formats contained in DPB8.L1B and 
control logic to the assembly. Future systems may take advantage of the 
"High-Density" 3.5 and 5.25" Floppy Disks which use higher data rates. Their 
definitions will be controlled by this flag as well. 

NOTE: If AUTOSL is set to NO. this option will probably cause the BIOS to be 
larger than necessary .since these additional formats may not be accessible. 

MORDPB - Use more Floppy DPB's (in addition to normal 4-5.25" and optional 
8")? If YES. the file DPB2.LIB is included. Many of the formats are Dummies 
and may be filled with any non-conflicting formats you desire. 

NOTE: If AUTOSL if set to NO. this option will probably cause the BIOS to be 
larger than necessary since these additional formats may not be accessible. 

MORDEV - Include Additional Character Device Drivers? Is set to YES. user- 
defined drivers are added to the Character 10 table, and associated driver 
code is assembled. Systems featuring expansion board such as the SB-1S0 and 
YASBEC may now take advantage of additional serial and parallel interfaces 
within the basic Bios. Set to NO to limit code to the basic 4 drivers. 

NOTE: When assembling a Bios for Boot Track Installation (MOVCPM set to YES), 
MORDEV is overridden to conserve space, and the Bios Version Number is forced 
to 1.1 in the distribution files. 

BUFCON - Use type ahead buffer for the Console? If set to YES. code is added 
to create and manage a type-ahead buffer for the driver assembled as the 
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console. This device will be controlled by either interrupts (in systems such 
as the YASBEC and SB-180) or background polling (in Ampro and Compu/Time). 
This means that characters typed while the computer is doing something else 
will not be lost, but will be held until requested. 

BUFAUX - Use type ahead buffer on Auxiliary Port? As with BUFCON above, set- 
ting to YES will add code to create and manage a type ahead buffer for the 
auxiliary device. Since the AUX port typically is used for Modem connections, 
buffering the input will minimize the loss of characters from the remote end. 

AUTOSL - Auto-select floppy formats? If set to YES, selection of Floppy disks 
will use an algorithm in SELFLP2.280 to identify the format of the disk from 
the DPB files included (DPB.LIB, optional DPBS.LIB, and optional DPB2.LIB) and 
log the disk if a match is found. There must be NO conflicting definitions 
included in the various files for this to function properly. See the notes in 
the various files to clarify the restrictions. If set to NO, the single file 
DPBRAM.LIB is included which may be tailored to contain only the fixed format 
or formats desired per disk drive. This results in the smallest code require- 
ment, but least flexibility. 

RAMDSK - Include code for a RAM-Disk? If set to ITS, any memory above the 
System or User bank may be used for a RAM Drive (default is drive M : ) by 
including the file RAMD-xx . ZSO . Parameters to determine the size and configu- 
ration are also included in the files DPHM-xx.LIB and DPBM-xx.LIB. In systems 
without extended memory, or to conserve space such as when building a system 
for the boot tracks, tins may be disabled by setting to NO. 

HARDDSK - Include SCSI Hard Disk Driver? Set to YES if you wish to include 
the ability to access Hard Disk Drives. In a floppy-only system, a NO entry 
will minimize BIOS code. 

HDINTS - (System Dependent) In some systems such as the YASBEC. Interrupt- 
driven Hard Disk Controllers using DMA transfer capabilities may be used. If 
you wish to use this type of driver specified in the file HARDI-xx.ZSQ instead 
of the normal polled routines included in HARD-.xx.Z80, set this option to 
TRUE. In most cases, this driver will require more Transient Program Area 
since the Interrupt Handling routine must be in Common Memory. 

CLOCK - Include ZSDOS Clock Driver Code? If set to YES, the vector at 
BIOS+4EH will contain a ZSDOS- compat ible clock driver with the physical code 
contained in the TIM-.xx.Z80 module. If set to NO, calls to BI0S+4EH return an 
error code. 

TICTOC - (System Dependent) Use pseudo heartbeat counter? This feature is 
used in systems such as the Ampro Little Board and Compu/Time SBC880 which do 
not have an Interrupt scheme to control a Real Time Clock. Instead, a series 
of traps are included in the code (Character 10 Status polls, Floppy Disk 
Status polls) to check for overflow of a 1-Second Counter. It is less desir- 
able than an Interrupt based system, but suffices when no other method is 
available. Set to NO if not needed. 

QSIZE - Size in bytes of type ahead buffers controlled by BUFCON and BUFAUX. 
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REFRSH - Act i vate Dynamic Refresh features of Z180/HD64180 processors'.' In 
some computers using these processors such as the YASBEC, refresh is not 
needed and merely slows down processing. Set to NO if you do not need this 
feature. If your processor uses dynamic memory, or needs the signal for other 
purposes (e.g. The SB1S0 uses Refresh for Floppy Disk DMA), Set this to YES. 

23 - Include ZCPR init code? Since a Z3 Environment is mandatory in a B/P 

Bios (which now "owns" the Environment), this option has little effect. 

For assembly of a Banked version of B/P Bios, the identification of various 
banks of memory must be made so that the various system components "know" 
where things are located. Refer to Section 3.1 above for a description of 

these areas. The BNKO value should be the first bank of RAM in the System 

unless other decoding is done. The following equates must be set: 

BNKO - First 32k TPA Bank (switched in/out) 

BNK1 - Second 32k TPA Bank (Common Bank) 

BNK2 - Beginning of System Bank (BIOS. DOS. CPR i area 

BNKU - Beginning of Bank sequence for User Applications 

BNK3 - Beginning of Extra Banks (first bank to use for RAM Disk) 

BNKM - Maximum Bank Number assigned 


3.4 Configuration Considerations. 

When assembling a version of B/P Bios for integration into an IMG file, size 
of the resulting image is not much of a concern, so you need not worry about 
minor issues of size. For integration into a system for loading onto diskette 
boot tracks, however, the limitation is very real in order to insure that the 
CPR/DOS/BIOS and Boot Sector! s) can fit on the reserved system tracks. Typi- 
cal lv. a limit of slightly under 4.5k exists for the Bios component. When the 
MOVCPM flag is set to YES for this type of assembly, warnings will be issued 
when the image exceeds 4352 bytes (the maximum for systems with 2 boot 
records), and 44S0 bytes (the maximum for systems with a single boot record). 
Achieving these limits often requires disabling many of the features. 

The first thing you should do before assembling the BIOS is to back up the 
entire disk, then copy only the necessary files onto a work disk for any 
editing. After setting the options as desired, edit the hardware definitions 
in ICFG-xx.ZSO to reflect the physical characteristics of your floppy and hard 
drives, as well as any other pertinent items. Then edit the logical charac- 
teristics for your Hard and Ram Drives (if any) in DPBHD-xx.LIB and DPBM- 
xx. LIB. If you do not desire any of the standard floppy formats or want to 
change them, edit DPP. .LIB and/or DPB2.LIB (if using auto selection) or 
DPBR.AM.LIB if you are using fixed floppy formats. Finally edit the DPH files 
to place the logical drives where desired in the range A. .P. 

Decide whether you want to generate a system using the Image file construct 
developed in support of B/P Bios ( BPBUILD/LDSYS ) . or for integration on a 
floppy disk's hoot tracks. If the latter, you probably will not be able to 
have all options turned on. For example, with the MicroMint SB- ISO. the 
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following options must be turned Off: BANKED. ZSD0S2, BIOERM. FLOPYS, MORDPB. 
BUFAUX and usually either CLOCK or RAMDSK. As an aid to space reduction, 
conditional assembly based on the MOVCPM flag automatically inhibits all but 
double-sided Floppy formats from DPB.LIB. If configuring for Floppy Boot 
tracks (MOVCPM flag set to TRUE), a warning will be printed during assembly if 
the size exceeds that available for a One or Two-sector boot record. Using 
the BPBUI LD/LDS YS method, you may vary nearly all system parameters, even 
making different systems for later dynamic loading. 

If you are using a version of the B/P Bios already set for your type of com- 
puter, you are now ready to assemble, build a system and execute it. The only 
remaining task would be an optional tailoring of the sign on banner in the 
file CBOOT-XX.Z80 and reassembly to a .REL file. 

For those converting a standard version of the B/P Bios to a new hardware 
system, we recommend that you begin with a Floppy-only system in Nan-Banked 
mode then expand from there. The easiest way to test out new versions is tc 
use the System Image (IMG file) mode, then advance to boot track installations 
if that is desired. Enhancements that can be added after testing previous 
versions may be to add Hard Drives. RAM Drive, and finally Banking. 
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4 Installing a B/P Bios. 

The Distribution diskette! s) on which B/P Bios is furnished are configured for 
booting from the vanilla hardware for the version ordered. A 9600 bps serial 
terminal is standard, and will allow you to immediately bring up a minimal 
non-banked floppy disk system. Due to the variety of different system config- 
urations and size restrictions in some versions, only the Floppy Disk Mass 
Storage capability can be assured on the initial boot disk. Where space 
remained on the boot tracks, limited Hard Drive support is also provided, and 
in some configurations, even RAM Drive support exists. 

After booting from either an established system, or the boot tracks of the 
distribution disk, format one or more fresh diskettes and copy the distribu- 
tion diskette! s) contents to the backup diskette(s). Copy the boot tracks 
from the master to the copies using BPSYSGEN (see 6.6). Remove the master 
diskette(s) for safekeeping and work only with the copies you just made. 

Using the backup diskette with the B/P utilities on it. execute BPCNFG in the 
Boot Track configuration mode (see 6.2). adjusting all the options to your 
specific operating environment. When you have completed tailoring the system, 
it is ready for booting by placing the diskette in drive A: and resetting the 
system. 

The sample STARTUP.COM file on the distribution disk will automatically exec- 
ute a sequence of instructions when the system is booted. It contains various 
instructions which further tailor the system and load portions of the operat- 
ing system which are too big to fit on the boot tracks. The default instruc- 
tion sequence is: 


LDDS <— 

LDR SYS . RCP , SYS . FCP , SYS . NDR <— 

IOPINIT <— 

TD S <— 

IF ~EX MYTERM.Z3T <— 

TCSELECT MYTERM.Z3T <— 

FI <— 

LDR MYTERM.Z3T <— 


Load the Dates tamper style File 
Stamp routine and clock 
Load ZCPK 3 Environment segments 
for Resident Command Processor. 
Flow Control Pkg and Named Dirs 
Initialize the 10 Processor Pke 
Prompt for Date and Time. Set Cik 
Alternatives are to use TDD 
(6.21) or SETCLOK (6.18) 

If the file MYTERM.Z3T does Not 
exist... 

..select which terminal you have 
creating a MYTERM.Z3T file 
. . .end of the If 

Load the Terminal Definition data 


If you wish to alter any of these initial instructions to, for example, ini- 
tialize the RAM drive using INIKAMD. add File Time Stamp capabilities to it 
with IN1TDIR or PUTDS and copy some files there with COPY, these may be added 
with ALIAS. VALIAS , SAL I AS or other compatible files available from the ZSYS- 
Ti.M or ZCPR33 areas on Z-Nodes. 
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After the initial system is up and running i rom the Default Boot Track system, 
you may expand the operation by generating systems tor different purposes in 
order to gain the most advantage from your system. Many types of installation 
are possible, the simplest of which is a Non -Banked system using only 64k of 
the systems memory, aii of which is in primary memory. Such a system uses a 
normal Command Processor such as the ZCPR3.X family, and a Non-Banked Operat- 
ing System such as our ZSDOS Version 1. Non-Banked systems may be installed 
on a E'isk's Boot Tracks, or created as an Image File for dynamic loading using 
the LDSYS Ut i 1 i ty ( see 6.15). 

Banked systems MUST be created with the BPBUILD Utility (see 6.1! and loaded 
with LDSYS (see 6.15). The techniques to manage different memory banks to 
form a complete Operating Environment are rather intricate and are best han- 
dled by our utilities. Many Image files may be created and loaded as needed 
to tailor your system for optimum performance. The following sections de- 
scribe these various types of installations in detail. 


4.1 Boot Track Installation. 

tor most of t he existing Cl'/M compatible computers to begin execut ing a iris! 
Operating System, a program must he placed on a specif ied area of a (• loppy of 
Hard I) ini. Drive. Normal Jy. the first two or three tracks on the disk a re 
reserved for this purpose and are referred to as the "Boot Tracks', since the 
space so defined i: general !y restricted, neither a complete B/P bios nor a 

banked ir--za I lat u'u i «- possible. Instead, a scaled-down system roughly equiv- 
alent to t hove current ly in use is used to start the computer ana serve a- the 
Operating System, v '• r h larger systems loaded later as needed. 

If you are using a pre-conf igured version oi B/P Bios for you r bar. Ivan . v s 
may singly continue tv use tin. Boot Track system 1 rom the distribution diskix; 
by copying the system as described in Section 4 above using BPSiSGEN (si. . 
6.0>. 1 f you elect to alter or otherwise customize the Boot Track system, you 

must assemble the M/t f tos source setting certain of the equates in the bid 

xx.i.lr file ts insure a correct type of system. To assemble a hoot Track 
sys t em . t he mos t i moo r t an t equa t e s a re : 

MOVCPM Set to YES 

BANKED Set to NO 

ZSD0S2 Set to NO 

one element of Banked Systems is available in a Boot Track installation it 
additional memory is available, and your B/P Bios routines support such <■ 
feature. This feature reloads the Command Processor from Banked memory in- 

stead of 1 rom the Boot Tracks of a disk, and generally produces less corf; 
(taking less space on the boot Tracks) and executes faster. It is set with: 

Set to YES if desired. NO if Warm Boot from disk 
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Some of the team res that generally need to be disabled to scale a smaller 
system are set as: 

MORDPB Set to NO 
DPB8 Set to NO 
MORDEV Set to NO 


When at least these equates and any others you desire to change (see section 
4) have been made to the component files of the system, assemble your BPBIO-xx 
file to a Microsoft standard REL file. This output file may be used to over- 
lay the Bios portion of the MOVxSYS.COM system generation utility (see 6.16) 
furnished with your distribution disk, or an equivalent program provided with 
your computer. MOVxSYS or its equivalent (MOVCPM, MOVZSYS. etc) is a special 
program customized for your particular hardware containing all the Operating 
System components which will be placed on the Boot Tracks, along with a rou- 
tine to alter the internal addresses to correspond to a specified memory size. 

To Add the ne' ; Bios you just assembled, execute INSTAL i 2 (see procedures in 
6.13) specifying your computer's MOVxSYS or equivalent program and iol low the 
prompts to overlay the new Bios. Once INSTAL! 2 has saved a relocatable or 
absolute file, you are ready to create a boot disk containing the mom Lied 
system. 

If you used the command INSTAL12 to install system segments on MOVxSYS or 
equivalent program . you must first create an Absolute System Model file. 
Since the functions f portion ol you j new program is idem ica i to the original 
MOVxSYS or equivalent . use the method explained in you r original documental ion 
to generate a new system. With MOVxSYS. the command is: 

MOVxSYS nn * < — replace M* )'v xSV s with your version 

V 'he ft nn is the size of the system (typically 51 ioi a moderate boot system ! . 
The asterisk tel i* the procram to retain the image in memory and not write it 
to a disk file. You may now use BPSYSGEN to write the new image to the system 
tracks of voijr hoot disketu. no this by executing BPSYSGEN with no arguments 
and issue a s ingle Carriage Return when asked for the source of the Image. 

It you use:: the command INSTAL12 /A to install replacement system segment: 
over a System Image file, or used a utility which wrote the new image to a 
disk lile. use BPSYSGEN to write the image file to the system tracks of your 
boot disk. The proper command is 

BPSYSGEN filename 

where filename is the name of the disk file you just created by executing 
MOVxSYS or equivalent with output to a disk file, or with INSTAL 12 on an 
existing image file. 

It the system is written to a Hard Disk, and your system supports booting from 
a Hard [risk such at the YASBHO, you normally must alter the default Boot 
sector from the default Floppy Disk Boot Sector contained in MOVxSYS or equv- 
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aleni. This alteration is accomplished by HDBOOT (see P.9) which must be 
customized to the specific Hardware System used. 

After the above actions have been completed as appropriate, tailor the Boot 
Track system to reflect the desired starting configurations with BPCNFG (see 
6.2). Such items as the desired Startup file name. Bank Numbers (critical if 
FASTWB is used), and drive types and assignments are routinely tailored at 
this point. When the you have finished this step, test your new system by 
resetting the system, or cycling the power and you should be up and running! 


4.2 Non-Ban ked Image Installation. 

A Non-Banked system may be installed as an Image File as opposed to the basic 
Boot Track installation covered in 4.1 above. To create an Image File, you 
must have RLt or ZR1. versions of a Command Processor ( ZCPR3 . x or equivalent 
recommended), an Operating (ZSDOS.ZRL recommended), and a RLL version of J,/i ■ 
Bios io? your system assembled with the MOVCPM equate in DEF-xx.Llb set to NO. 
Other equates in this file may be set as described above lor the boot 1 rack 
system. Since ] mage files are not as constrained in size as is installation 
for Boot Tracks, more features may generally be activated such as F.rror Mes- 
sages. RAM Drive, additional Hard Drive partitions, and complete Floppy Format 
suites. The main precaution here is that large Hard Drives will rapidly cause 
sienit icant loss of Transient Program Area since all Drive parameters must be 
in protected high memory above the Bios. 

Aftcu the Bios has been assembled, an image file must be produced . This *s 
accompi isheu t h the BPBliT.D btiiitv ( see 6.1). Set the File names in Menu .1 
to reflect only Non-Banked files (or minimally banked bios if FASTWB is set. to 
YES and 1 el BPBIT LI' do the work. since the standard Non-Banked System 
segments are norma i i y set to the 'standard" CP/M 2.2 sizes, you may answer the 
"autosize' query with a Y to obtain the maximum Transient Program Area in the 
resulting system. When BPBl 1 l.b completes its work, a file, normal ly with the 
default type of . IMG, will hate been placed in the current ly logged Drive /user 
area and you are reaay to perform the next step in preparation of the Non- 
banked i mage . 

As with the boot Track installation covered above, several system items must 
be tailored before the Image may be safely loaded and executed. This is done 
by calling BPCNFG with the Image tile name as an argument, or specify Image 
configuration from the interactive menu (see 6.2). Set all items as you 
desire them in the operating system, particularly the Bank Numbers (if FASTTe 
is active), and the Disk Drive characteristics and assignments. When this has 
been satisfactorily completed, you are ready to load and execute the newly- 
created system. 

Installing an Image File (default file type of .IMG) is extremely easy. Only 
the utility LDSVS.COM (see 6.15) is needed. If the file type has not been 
changed from the default .IMG, only the basic name of the Image File need be 
passed to LDSYS when executed as: 

LDSYS IMGFILE < — Where IMGFTLF. is your Image tile name 
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The operating parameters of the currently-executing system are first examined 
for suitability of loading the Image File. If it is possible to proceed, the 
Image File is loaded, placed in the proper memory locations, and commanded to 
begin execution by calling the B/P Bios Cold Boot Vector. The Cold Boot 
(Bios Function 0) performs final installation, displays any desired opening 
prompt and transfers control to the Command Processor with any specified 
Startup file for use by a ZCPR.i . x Command Processor Replacement. 

Since a non-banked Image File will probably closely resemble that contained on 
the Boot Tracks, the same STARTUP file may generally be used to complete the 
initial tailoring sequence. If a different file is desired, the Image File 
may be altered to specify a different file using BPCNFG. 


4.3 Banked Bios, Non-banked System Installation. 

With the B/P Bios system, an Image system may be created and loaded which 
places portions of the Bios Only in the System bank, retaining a non-banked 
Operating System and therefore maximum compatibility with existing applica- 
tions software. A few thousand bytes can normally be reclaimed for Transient 
Programs in this manner, although large and/or increasing numbers of logical 
drives will still reduce TPA space because of the need to store Allocation 
Vector information in Common Memory. 

To prepare such a system, simply edit the needed bios files if necessary wit): 
particular emphasis on the bis .1.1 b file where the following equates must be- 
set as: 

MOVCPM Set to NO 

BANKED Set to YES 

ZSD0S2 set to NO 

Since banked memorv MiS'l be available for this type of installation, you w i i ) 
probably want the Fast Warm hoot feature available to maximize system perfor- 
mance . To activate this option, set the following equate as: 

FASTWB Set to YES 

When the editing is complete, assemble the Bios to a Microsoft .RLL file with 
an appropriate assembler such as ZMAC and build an Image system with BPBL’lLb 
(see 6.1) changing the Bios file name in menu 1 to the name of the newly 
created Bios file. Next, configure the default conditions if necessary with 
BPCNFG (see 0.2 ) and you are ready to activate the new system in the same 
manner as all Image files by calling LDSYS with the Image file argument as: 

LDSYS BBSYS < — where BBSYS is your Image File Name 

As with the completely Non-Banked system described above in Section 4.2. no 
new requirements are established for a Startup file over that used for the 
initial Boot System, since both the Command Processor and Disk Operating 
System are unbanked . and no data areas needed by application programs art 
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placed in the System Bank. As with all Image Files, additional features such 
as full Bios Error Messages, more extensive f loppy Disk formats and RAM drive- 
may generally he included in the System definition prior to assembly since the 
size constraints of Boot Track systems do not apply. 


4.4 Fully Banked Image Installation. 

To create a system taking maximum advantage of banked memory, a special banked 
Operating System and Command Processor are needed. These have been furnished 
in initial form with this package as ZSDOS20.ZRL and Z40.ZRL respectively. 
They use the Banking features of B/P Bios and locate the maximum practicable 
amount of executable code and data in the System Bank. Of significant impor- 
tance to maximizing the Transient Program Area is that the Drive Allocation 
Bit maps are placed in the System Bank meaning that adding large hard drives, 
or multiple drives produce only minimal expansion to the resident portion ol 
the Bios. 


A fully banked Bios is created by editing the B/P Bios files as needed to 
customize the system to your desires. Insure that the following DEF-xx.l.ln 

0 QUfi T. S el f £■ $ C t ft 5 *. 


MOVCPM 

Se t 

to 

NO 




BANKED 

Set 

to 

YES 




ZSD0S2 

set 

to 

res 




■ resultant B/P 

Hi os to a 

Microsoft . R 

Jl. file. Build an 

(mace i.i 

.1 e 


with BPBPi-.D t see 0.1; and coni' i re the produced Image file with BPCNFii (see 
0.2). When you arc- coni icier i that ail default settings have been made, acti- 
vate the file by entering: 

LDSYS FBANKSYS < — where F BANKS YS is your J mage file name 

Several differences may exist in the Startup file used for a Fully banked 
system. Genera! tv the changes amount to deleting items such as a file stamp 
module lor the Non-banked ZSBOsj which is not necessary with the fully-banked 
ZSIX.’S 2 and 7.40. Only the type of clock need be specified for ZSDOS2. 1 in - 
thermore. since the 240 Command Processor Replacement contains most common 1 y- 
used commands gathered from a number of Resident Command Processor ( RcP ) 
packages, there is normally no need to load an RCP. A simple Startup file 
found adequate during development of the fully-banked B/P system is: 


ZSCFG2 CB 

< 

Set ZSDOS 2 dock to Bios+41-.H 

LDR SYS . FCP , SYS . NDR 

< 

Load ZCPR 3 Lnvi ronment segments 
for How Control and Named Dirs 

IOPINIT 

< 

Initialize the 10 Processor Pkg 

TD S 

< 

Prompt for Date and lime. Set elk 
Alternatives are to use TDD 
(6.21/ or SETCLOk ( 6 . 1 S ) 

IF ~EX MYTERM.Z3T 

< 

If the file MYTERM . Z3T does Not 

exist. . . 

TCSELECT MYTERM. Z3T 

< 

..select which terminal you ha vc 
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creating a MYThKM.Z.VJ rile 

FI < — . . . end j 1 the If 

LDR MYTERM.Z3T < — Load the Terminal Definition data 

Since the requirements tor a fully-banked system differ significantly t rom a 
non-banked one, we recommend that you use a different name tor the Startup 
file. For example, STARTUP.COM is the default name used with Boot Track 
systems for initial operation, and with Non-banked Image Files, while STARTB 
may be a suitable name lor the script to be executed upon loading a fullv- 
banked system. The name of the desired Startup file may be easily altered in 
either Boot Track or Image systems from Option i in BPCNFG (see 6.2). 

An option available to start from a large Image File is to configure a Startup 
file for execution by the Boot Track system containing a single command. The 
command would simply invoke LDSYS with the desired Banked Image File as an 
argument such as: 

LDSYS BANKSYS < — Whc-re BAKKM’S. JMG is your image- tile 

In this case, none of the normal initialization sequences cited above would be 
executed by the Boot Track system, and only those contained in the Startup tor 
BANKSYS . 1 MG would occur. Other options abound and are left to the community 
to invent new comb mat ions ana sequences . 


4.5 In Case of Problems... 

While We attempted to outline procedures lor 1 he majority of installation:- we 
considered feasible, there may be occasions whe re you inadvertent ly J i rid 
yourself in a posit. on wnere you seem to have lost the ability to get you r 
system up and running. 

PROBLEM: When loading an .Ido file with LDSYS. the screen displays the l.bsfS 

banner, system aaciress.es, and halts with the last screen displaying: 

. . . loading banked .system' . 

SOLUTION Something is not set correct iy in the Bios, since ali i in-on 
after the last one displayed are printed from the newly-loaded Bios. one of 
the most common causes tor this problem is incorrect bank number settings. 
Use the hidden selection m Menu 1 of BPCNFG (see 6.2) to verify that the 
correct bank numbers have been set for TPA and SYS tern banks. Another common 
cause of this problem is incorrect settings for the Console port, or a setting 
in the IOBVTF which directs Console data to a device other than the one in- 
tended. Use Menu 2 BPCNFG to properly set the I0BYTE and the console parame- 
ters . 

PROBLEM: You boot from or load a B/P Bios system from a Hard Drive, and 

immediately after starting, the system attempts to log onto Floppy Drive U. 

— SOLUTION': The most common cause for this symptom is that the desired 

Hard Drive and Floppy Drive definitions were not swapped to define a hare 
Drive Partition as the A: drive. Use BPCNFG (see 6.2), Menu g to exchange 
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drives to the desired configuration. A similar situation may exist where a 
Hard Drive is activated immediately after booting when a floppy drive is 
desired as the A: Drive. 


PROBLEM: The computer seems to boot satisfactorily, but after a few programs 
or any program which executes a Warm Boot (or entering Control-C), the system 
goes into "Never-never Land" and must be reset . 

SOLUTION: This symptom is most often caused by an inability to access 
and load the Command Processor. This is most probably caused by assembling 
B/P Bios with the FASTWB equate in DEF-xx.LIB set to YES when the system 
contains no extended memory, or incorrect settings of the Bank Numbers. To 
check Bank Number .settings, use the hidden function in BPCNFG, Menu 1 (see 
6 . 2 ). 

PROBLEM: When doing a Cold Boot from a Hard Drive (from Power up or Reset), 
the system goes to a floppy Drive before displaying the initial sign on mes- 
sages, and remains logged on the Floppy. 

SOLUTION: This is most often due to your forgetting to run the HDBOOY 
utility on the Hard Drive boot system after applying it with BPSYSGEN . Nor- 
ma]]}'. systems created with MOVx.sYS contain a f loppy Disk Boot sector which 
will load the initial Operating System from a floppy. HDBOOT (see o.9) modi- 
fies this record on a specified Hard Drive Unit so that the Operating System 
is loaded f rom a Hard Drive. Run HDBOOT on the Desired Hard Drive, then use 
BPCNFG (see b.2; to insure that the logical drives are positioned a: desired 
(Menu 5). 

PROBLEM: When Boot ing . the system console either doesn't display anything, or 
prints strange characters. 

SOLUTION: This is most otten due to incorrect settings for the current 
Console, most probably the Data rate, or CPC Clock Frequency. boot from a 
good system, then use BPCXIC (see 6.2 ) to adjust the settings on the problem 
system. Pay particular attention to Menu 1 ( CPU clock Rate) and Menu 2 
(IOBYTL and Serial Port Data Rates). 

PROBLEM: When running a fullv-banked system with ZSDOS 2. some programs seem 
to "hang' or "lock up" the system on exit. 

SOLUTION: One of the most common sources of this symptom is with the 
application program where the author used code which assumes that the BDOb and 
Command Processor are of a certain size, or bear a fixed relationship to the 
addresses in page 0. You may experience this most often when using an IMG 
system built by answering YES to the Autosizing query in BPBUILD (see 6.1). 
To compensate lor such ill-behaved programs, you may use a two-step bui id 
process as: 

1) Use BPBUILD to create an IMG file answering YES to Autosizing on exit. 
This maximizes TPA placing the Resident Bios as high as possible in memorv. 

2) Execute BPBUILD again with an argument of the name you gave to the liie 
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just created above. This Joads the definition from the IMG file. immediately 
exit with a Carriage Return, and answer NO to Autosizing, and YES to piscina 
system segments at standard locations. This procedure keeps the Bios address 
constant, but will move the starting addresses of B1X)S and Command Processor 
down, if possible, to simulate ' standard” sizes used in CP/M 2.2. 
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5. Programming for B/P Bios. 

For most existing purposes, programming for B/P Bios is no different than for 
standard CP/M 2.2 BIOSes. Even adapting CP/M 3 programs for a B/P Bios should 
present no great hurdle due to the close similarity retained with the corre- 
sponding extended functions. The power of a B/P Bios interface, however, is 
in using the combined features to produce portable software across a wide 
variety of hardware platforms by exercising all of the B/P Bios features in 
concert. This section describes the interfaces available to the programmer of 
a system using the B/P Bios, and the functions available to ease direct floppy 
and hard drive accesses for specialized programming in a consistent manner. 


One of the architectural flaws which we considered in CP/M Plus was the odd 
way in which direct BIOS access was handled. We designed B/P Bios to be as 
compatible with CP/M 2.2 as possible, yet provide the expanded funct ional i ty 
needed in Banked applications. To that end, direct interface with BIOS cal is 
follows CP/M 2.2 conventions as much as possible. 

The following pages on programming assume some familiarity with the basic CP/M 
fundamentals, and with ZBO/ZJSO assembly language, since it is beyond the 
intent of this manual, and our literary writing skills, to present an assembly 
programming tutorial. Should you need additional assistance in this area, 
please refer to the annotated bibliography lor reference material. 


5.1 Bios Jump Table. 

The BIOS Jump table consists of 3b Jumps to various functions within t* HI Ob 
and provides t he basic functionality. It includes the complete CP/M 2 . 2 
sequence . most of the OP/M 3 (aka CP/M Plus ) entry points (although some 
differ in parameter ordering and/or register usage), and new entry points 
needed to handle banking in a consistent and logical manner. 

Bios entry points consist of a Table of Absolute 3-byte tumps placed at the 
beginning ol t he- executable Image. Parameters are passed to the Bios in 
registers as needed for the specific operation. To avoid future compatibility 
p r o b 1 e m s , s o me o f the ground rule s f or Bios construction inci u cl e : N o 
alteration of Alternate or Index registers as a result of Bios calls, and all 
registers listed in the documentation as being Preservea/Unaffecteci ML FT b<_ 
returned to the calling program in their entry state. Bios entry points are: 


If 

|| 

l: 


II 

j| 


Function 0 (xxOO) 


truer: None 


H 

j Exit: 


Uses: 


Cold Boot 

None . 

Execution resumes at CPR 
All Registers 


I 


Execute boici Start initialization on the first execution. The jump argument 
is inter overwritten, and points to the 10P Device jump table. The reason for 
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this is that code to perforni the initialization is often placed in areas of 
memory which are later used to store system information as a memory conserva- 
tion measure. Attempts to re-execute the initialization code would then 
encounter data bytes instead of executable instructions, and the system would 
most assuredly ''crash". 

Among other functions performed during initial execution of the Cold Boot cooe 
are; Establishing an initial Z3 Environment if necessary, initializing any Z3 
system segments such as an Extended Path, Flow Control Package, Named Direc- 
tory Buffer and such: setting system-specific values such as the locations of 
Allocation Vector buffers for RAM and Hard Drives; and executing the Device- 
Initialization routine (see Function 21). The Cold Boot routine usually exits 
by chaining to the Warm Boot Function (function 1) to set vectors on Page 0 of 
the TP A memory bank. 


fr 


1 Function 1 (x;-:03) 

Warm Boot | 

r ~ ~ ■ ■■■ ' — 

i Enter: None 

11 . - — j 

Exit; None. 1 


Execution returns to CPK 1 

i 

I 

i 

Uses; All Registers j 

< 


This function re- initial izos the Opornt in? system and returns to the Command 
Processor after re 1 cad 1 1 1 - 1 1 • rom the default drive boot tracks, or h.uiKe-c 

memory if tut Pios was assembled with t iv. Fast Warm Boot opt ion. 

Unless altered by an i 1 1 -behaved Resident System Extension (KSX- or other 
ope rat ing transient program, the Warm Boot Vector at location () in memory 
points to this vector. V.e i i -behaved programs will not alter this address but 
should, instead, alter tht destination argument oi the Jump vector in the Bio-, 
header. There is a singular exception to this in the case of NZC'OM where the 
Warm Boot vector point: 1 to the NZ.B10S. and Not tne 'Real' Bios. in such, n 
case . the address i.; the 'Rea; Bios must ne separately determined ( See I uni - 
t i on 30 ) . 


ir 

II Function 2 ( xxu6 ) 

i _ 

Console Input Status jj 

.... . . — .. . Ji 

r " - ' “ ' ~ t 


j Enter: None 

|j Exit: A = OR F hi if Char Ready, NZ I 

! 

- A = 0 if No Cnar Ready, Z 1 

P i 

i i 

1 

!i 1 

i Uses : AF : 

It — — i 

IL - -- - i: 


This function returns a f i as indicating whether or not a character has been 
entered from the Console device selected by the IOBYTE on Page 0 of tne Ti 
bank. The return statu- 7 is often used by Transient Programs to determine if 
the user has attempted to start or stop program execution. 
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i Function 3 ( xx09 ) 

ji .. . 

j 

Console Incut | 

i 

j Enter: None 

| * - • — ] 

| Exit: A = Masked Input Character 

j 


i Uses: AF 

ii 

ii 

; i 


This function waits for a character to be entered from the Console device 
selected by the I GBYTE on Page 0 of the TPA Bank, and returns it to the call- 
ing routine. According to strict CP/M 2.2 standards, the Most Significant bit 
of the input byte must be set to Zero, but this may be altered by the input 
mask for the Console Device. 


Ii Function < 

i (xxOC) 





Console Output ]i 

| Enter: C = 

Character to send to 

r 

j 

r — 

Exit: 

None . 

ii 

i 

Console 

1 




1! 

ii 

1U~ - . 


ii 

Ji 

Uses : 

AF 

|j 


This 1 unction sends a specified character to the Console Device defined by the 
IGJVYTi on Page 0 of the TP a Bank. It will wait for the device to become 
ready . if necessary. b<. fore sending t he character, and will mask, bits a.- 
specifier in the Character Dev j ce < out igurat ion j or the device as an Output . 


|; Function 5 ( x:-:OH List Output jj 

i! Enter: C - Character to send to j; Exit: None. j'i 

I List Dev (Printer) ji jj 

| ii Uses: AF | 


This i unction will send a specified character to the List Device (Printer : 
defined by the 10BYTL on Page 0 of the TPA Bank. It wiil wait for the device 
to become ready, if necessary, before sending the character, and will mask 1 1 
as specified in the Character Device Configuration for the Output device. 
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1 ■ ■ - - 

i Function 6 (xx12) 

i 


1 

Auxi 1 lary Output j 

„ J 


r " — 

■ - - - - 1 

1 Enter: C = Character to send to 

Exit: None. 

i 

Auxi 1 i ary Devi ce 



l 

Uses: AF 

i ... 

— 


This function will send a specified character to the Auxiliary Output Device 
defined by the IOBYTE on Page 0 of the TPA Bank. It will wait for the device 
to become ready, if necessary, before sending the character, and will mask it 
as specified in the Character Device Configuration for the Output device. 


i 





1 Function 7 (xx15) 

i 




Auxiliary Input | 

... - - - ... . i> 

r 

f Enter: None 

‘ - “IF ■ 

I 

li 

Exit : 

A = 

■■ " ' ■ ■ 

Masked Input Character 

i 

1 

L_ - _ - _ 

ii 

ii 

i! 

Uses: 

AF 

1 


This function will read a character from the Auxiliary Input Device detined by 
the 30BYT1 on Page 0 of the TPA Bank. It will wait for a character to be 
received, and will mask it as specified in the Character Device Configuration 
for the Input device. 


! Function £ (xx18.) 

1 


Home Drive 

~i'i 

Ii 

1 ' 

i Enter: None 

! Exit: 

None. Heads on selected 

i 

i 

i 

drive moved to Track 0. 

1 

1 1 

! Uses: 

li_ . .... 

AM Primary Regisxers 

ii 


This function will position the head(s) on the selected drive to Track 0. In 
B/P Bios, This operation performs no useful action, and is simply a Return. 
Pending Write purges and head repositioning is handled by the individual 
device drivers (Specifically Select Drive functions). 
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i Function 9 (xxlB) Seiect Logical Drive j 

- J 

i — 

Enter: C = Desired Drive 
(A=0. . P= 1 5 ) 

! 1 

Exit: (Success) A <> 0, NZ 

i HL = DPH Address 

; (No Drive) A = 0, Zero (Z) 

HL = 0 

j Uses: All Primary Registers 
1 — ■ — - — — 


This function selects a specified logical drive as the current drive to which 
disk operations refer. if the operation is successful, the Disk Parameter 
Header (DPI!) address is returned for later determination of the unit parame- 
ters If the operation fails for any reason (non-existant drive, unknown or 
bad media, etc), a Zero value pointer is returned to signify that the drive 
cannot be accessed through the Bios . 


|p " ~ — - — - — - — - 

| Function 10 (>..■. ft! 
jh====_=====^ 

ji Enter: BC - Desiree 1 racf Number 

!i 

1 

This function stores a specified Log i ca ! Track number for a future disk opera- 
tion. The i as t value stored with this function will ne the one used in Disk 
Reads and Writes. 

NOTE: While a i 6-bit vaiue is specified for this function, on i y the lower byte 
( h-b its) is used in most drivers. 


Seiect Track j! 
i| Exit: None. Track Number saved ji 

i! ii 

ij User: No Registers i 1 


| Function 1 1 ( xxi‘1 > 


Se 

ect Sector 

r ■— *- 

j Enter: BC = Desired Sector Nurri 

i LXit: 

None. Sector 

Numoer saved 

| 

| Uses: 

No Registers 

__ 


This function stores a specified Logical Sector Number lor a future disk 


operation. ihe last value stored with 
Disk Reads and Writes. 

NOTE: Wniie a 16-bit value is specified 
(8-bits) is used in alf floppy Disk and 


this function will be the one used in 


for this function, only the lower byte 
most Hard and RAM Disk drivers. 


o o 
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j Function 12 (xx24) 

Set DMA Address for Transfer j 

! 

[ - 

| Enter: BC - Buffer Starting Addr 

| Exit: None. DMA Address saved 
| 


1 

j Uses: No Registers 
i ! 


This Function stores a specified address to be used as the Source/Destination 
for a future disk operation. The last value stored with this function will be 
the one used in Disk Reads and Writes. In banked systems, the Bank selected 
for the transfer may be altered by Function 28. 


h - 

! Function 13 (xx27) 

i 

Disk Read | 

! 

! Enter: None 

" - - 

i Exit: A = 0, Z l f No Errors 


A - Non-Zero if Errors, NZ 


j Uses: All Primary Registers 

t . „ 

l . - _ - J 


This function reads a Topical 128 -byte sector from the Disk. Track and Sector 
set by Functions 9-11 to the address set with Function 32. On return. Reg- 
ister A=() if the operation was successful . Non-Zero if Triors occurred. 


if- 

I 

Function 14 

i xx2A i 



* ' Jl 

Disk Write ii 

ti- 

ll 

Enter: C = 1 

for immediate write j 

Exit : 

A - 

0, Z if No Errors ji 

it 

C = 0 

for buffered write | 


A -• 

Non-Zero it Errors. NZ ji 

1! 

IL= 


i 

Uses : 

Al 1 

Primary Registers ji 


This function writes a logical 128-byte sector to the Disk. Track ana Sector 
set by Junctions 9-1 1 from the address set with Function 12. If Register ( =! . 
an immediate write and flush of the Bios buffer is performed. 11 c-0, the 
write may be delayed due to the deblocking. 


Ir 

V, 


1 Function 15 (xx2D) 



List Output Status 

1! 

I " ’ " " " 

1 Enter: None 

Exi t : 

A = 

OFFH , NZ if ready tor 

I! 

ii 

I 



Output Character 

ii 

1 


A = 

0, Z it Printer Busy 

ii 


Uses: 

... 

AF 


Ji 


This function returns a flan indicating whether or not tne printer is ready to 
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accept a character. It uses the 10BYTE on Page 0 of the TPA Bank to determine 
which physical device to access. 


' " ' 

Function 16 (xx30) 

— — — — — =jt 

Perform Sector Translation j 

Enter: BC = Logical Sector Num 

- " 1 

Exit: HL = Physical Sector Num ! 

DE = Aa'dr of Trans Table 

! 

i . ... , .. 

Uses: All Primary Registers i 

i .... ... l 


This function translates the Logical Sector Number in register BO (Only C used 
at present) to a Physical Sector number using the Translation Table obtained 
from the DPI! and addressed by Dll. . 

This ends the strict CP/M 2 . 2-comp 1 i ant portion of the Bios Jump Table. The 
next series of entry Jumps roughly follows those used in CP/M 3. but with 
corrections to what we perceived to be deficiencies and inconsistencies in the 
calling parameters and structures. 


| Function 17 (xx.33) 



Console Output Status 

i: 

.)i 

! Enter: None 

■■ • ™ — ir~ 

ii 

Exit: 

A - OFFH, NZ if Console 

i 

1 

!! 


Ready for output char 

ii 


1! 


A = 0, Z if Console Busy 

i ! 

; 

ii 

Uses: 

At 

1 


This function returns a flag indicat ins whether or not the Console Device se- 
lected by the I0BYT1. on Page 0 of the- TPA Bank is ready to accept anotiv. r 
output character. 


ij Function IS (x>;36) 


Auxiliary Input Status 


Enter: None 


Exit: A = OFFH, NZ if Aux Input 
has character waiting 
A = 0, Z if No char ready 
Uses: AF 


This function returns a flag indicating whether or not the Auxiliary Input 
selected by the IOBYTE on Page 0 of the TPA Bank has a character waiting. 
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| Function 19 (xx39) Auxiliary Output Status ji 

P " ‘ i 

Enter: None 

i 

L ^ 

|; 

Exit: A = OFFH, NZ if Aux Output ii 
Ready for output char 
A = 0, Z if Aux Out Busy 
Uses: AF 

l 


This function return a flag indicating whether or not the Auxiliary Output 
selected by the IOBYTE on Page 0 of the TPA Bank is ready to accept another 
character for output. 


i Function 20 (xx3C) 

Return 

Pointer to Device Table 

1 

—.ii 

.. . ... - -- - ~ 1 

r 


ii 

| Enter: None 

Exit: 

| 

HL = Adar ot Device Table 

p 

« 

i 

l'i 

# 

1 

i Uses : 

HL 



This function roughly correspond', to an analogous CP/M Plus function although 
precise bit clef ini t ions vary somewhat . The Character 10 table consists oi 
four devices: COM; . COM2 . }’I0. and NU1.. Each has an input and output mask, 
data rate settings and protocol flags. Not a)] del men settings ' e . g . .-v :K/N‘AK 
and XOX/XOF] handshaking, etc) may be fully implemented in each version. bn’ 
are available for later expansion and use . 


Initial ize Devices |j 

if" = -== — ■ == i! 

ji Exit: None. Initialization done || 

ii ij 

)j Uses: All Primary Registers jj 


This function initializes Character 10 settings and other functions whicn may 
be varied by a Configuration Utility. It is an extended version of the corre- 
sponding CP/M Pius function. Its primary use is to restore 10 configurations, 
system parameters such as clock rate, wait states, etc. after alteration by 
programs which directly access hardware such as many modem programs and the 
conf igurat ion utility. BFONFG (see 0.2}. 



Function 21 ( xx3F ) 



Enter: None 


if 
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J Function 22 (xx42) 

Return DPH Pointer 

i Enter: None 

Exit: HL = Address of start of 

! 

Table of DPH Pointers 

1 

Uses: HL 


This function returns a Pointer to a table of 16-bit pointers to Disk Parame- 
ter Headers for Drives A-P. A Null (0000H) entry means that no drive is 
defined at that logical position. 


Function 23 (xx45) 

<Reserved for Multiple Sector I0> 

Enter: None 

j 

i Exit: 

None . 

ii 

j Uses : 

No Registers 

L 

i 


This function, is Reserved in the initial B/P Bios release and simply returns. 


Flush Deblocker jj 

Exit: None. Pending Disk Writes j! 

Executed. jj 

Uses: All Primary Registers )j 


This function writes any pending Data to disk from deblocking buffers as men- 
tioned in Function 14 above . This function should be called in critical areas, 
where tasks are being swapped, or media is being exchanged when it is possible 
that the Operating System will not detect the change. 


I Function 24 (xx48) 
L— 

i Enter: None 


L 


Function 25 (xx4B) 


Perform Possible Inter-Bank Move 


Enter : 


HL = Start Source Address 
DE = Start Dest Address 
BC = Number Bytes to Move 


Exit: None. Data is moved 
Uses: All Primary Registers 


This function moves the specified number of bytes between speciiied locations. 
For banked moves, the Source and Destination banks must have been previously 
specified with an XMOVL cal! (function 291. Note that the B/P implementation 
of this function reverses the use of the DE and HL register pairs from the 
CP/M 3 equ i va 1 en t f un c t i on . 
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Function 26 (xx4E) 

Get/Set Date and Time 

Enter: DE = Start of 6-byte Buff 

1 " ' 1 " • 

Exit: A = 1 of Successful 

C = 0 (to Get Date/Time) 

A = 0 if Error or No Clock 

C = 1 (to Set Date/Time) 

Uses: All Primary Registers 

L 


This function provides an interface to programs for a Real-Time Clock driver 
in the Bios. The function uses a 6-byte Date/Time string in ZSDOS format as 
opposed to Digital Research's format used in CP/M Plus for this function. 
Also, This function must conform to additional requirements of DateStamper ( tm ) 
in that on exit, register E must contain the entry contents of (DE+5) and HL 
must point to the entry (DE)+5. If the actual hardware implementing the clock 
supports 1/10 second increments, the current 1/10 second count may be returned 
in register D. 


j Function 27 (xx51 ) 



Select Memory Bank 

r — " 1 " " — 1 

j Enter: A = Desired Memory Bank 

f "" 

Exit : 

None . 

Bank is in Context 




in range 0. . 7FFFH 

i 

i .... 

Uses: 
! . 

AF 



This function selects the Memory Bank specified in the A register and make it 
act ive in the address range 0-TIT11. Since character 10 may be used when a 
bank other than the TPA (which contains the IOBVTE) is activated with this 
function, the B/P Bios automat ical iy obtains the IOBVTE i rom the TPA bank to 
insure that Character 10 occurs with the desired devices. 


!l Function 28 (>x54) Select Memory Bank for DMA j 

li . .. .. . ! 

ip 

Enter: A = Memory Bank for Disk 
j DMA Transfers 

I 

H ■ ■ ■ 

— 

Exit: None. Bank Number saved 
for later Disk 10 
Uses: No Registers 
— , 


This function selects a memory Bank with which to perform Disk 10. Function 
12 (Set DMA Transfer Address) operates in conjunction with this selection for 
subsequent Disk 10. 
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| Function 29 (xx57) 

i 


Set Source & Dest Banks for Move 

- ... . li 

Enter: B - Destination 
C = Source Bank 

Bank Num 
Number 

■ 

Exit: None. Bank Nums saved for 
MOVE operation 
Uses: No Registers 

i 


This function sets the Source and Destination Bank numbers for the next Move 
(Function 25). After a Move is performed, the Source and Destination Banks 
are automatically reset to TPA Bank values. 

This marks the end of the CP/M Plus "Type" jumps and begins the unique addi- 
tions to the B/P Bios table to support Banking, Direct 10 and interfacing. 


(r= 

| 

Function 30 (xx5A) 



Return BIOS Addresses j 

I 

[l 

Enter: None 

If 

j Exit: 

A 

ii 

= Bios Version (Hex) i 

ij 


li 

BC 

= Addr of Bios Base ; 

ji 


ij 

DE 

= Addr of Bios Conti g ! 

i 


HL 

= Addr of Device Table j 

ii 

L= 


1 Uses: 

ii 

All 

Primary Registers l 

r Jj 


This function returns various pointers to internal BIOS data areas and the 
Bios Version Number as indicated above . The Bios Version may be used to 
determine currency of the system software, and will be used by various support 
utilities to minimize t he possibility of data corruption and/or as an indica- 
tor of supported features. 

The Base Address of the Bios Jump Table returned in register RC is often used 
to insure that the proper indexing is achieved into tne B/P data structures in 
the event that a Bio- "she I i has been added such as when running NZC'OM . 
V.hiie the Warm Boot jump at memory location 0000H normally point? to the Bios 
Base+3 . it is not always reliable, whereas this function will always return a 
true value with B/P Bios. 

Registers DE and HI. return pointers which are of value to programs which alter 
or configure various Bios parameters. The pointer to the configuration area 
of the Rios should be used in utilities as opposed to indexing from the start 
of the Bios Jump Table since additions to the Jump Table or insertion of other 
data will affect the Configuration Area starting address. The pointer in Hi. 
is available for use in systems which may contain more than four character Jo 
devices. This pointer enables exchanges of devices to place desired devices 
in the first four positions of the table making them available for selection 
via the TOBYTE. After any alterations are made to the devices, a call to the 
Device cor.f igurat ion bios Function 21 should be made to activate the features. 
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FLOPPY DISK SUBFUNCTIONS. 

Function 31 permits low-level access to Floppy and Hard Disks (via SCSI inter- 
face) by specifying a Driver Number and desired Function. While some hardware 
types do not support all of the parameters specified, particularly for Floppy 
Drives, this architecture supports ail types, although specific systems may 
ignore certain functions. In this manner, for example, a single Format pro- 
gram supports NEC765, SMC9266. WD1 770/1 772/179x and other controller types 
with widely differing interfaces. Floppy Disk functions are accessed by 
entering a 1 value into Register B (Floppy Driver Number) and the desired 
function number in Register C. then jumping to or calling BIOS Entry jump 
number 31. 


j Function 31 (xx5D) 

) Floppy SubFunct ion 0 

i. ... 

— ji 

Set Floppy Read/Write Mode j 

j 

- ■ - ... Ji 

I Ente 1 ": A = 0 for Double Density 

j jj 

i Exit: None. || 

1 FF for Single Density 

1 Ii 

j B = 1 (Floppy Driver) 

i Uses: AF |i 

| C = 0 (Subfunction #.) 

i Ii 


It 


This routine establishes the Density mode of operation of the Floppy bisl 
Control ler for Read and Write accesses. 1 1 assumes that SubFunct ions .1 (Set 
Size and Motor) and 3 (Set Sector) have been called first. 


|i 

I 

i! 

It 


Function 31 (xx5D) Set Floppy Disk & Motor Farms. i; 

Floppy SubFunct ton 1 ji 

Enter: A - 0 to*- 300 rpm ( normal )|i Exit: None. jj 

FF for 360 rpm (S”/HD)ji I; 

D = FF tor Motor Control, ji Uses: AF ;i 

0 it Motor" always on jj ji 

E = Disk Drive Size ii ji 

B - 1 (Floppy Driver) jj ji 

C - 1 (SuDtunction #) i! I! 

ii = f 


This routine establishes some of the physical parameters for a Floppy Drive. 
The norma! 5 . 25 " and 3.5' disk drives holding 400 or 800 kb or less rotate at 
300 rpm. Many of the newer drives can increase this speed to 360 rpm which is 
the rate used on older 8" floppy drives. This is the speed used on the "High 
Density" 1.2 MB (IBM formatted) 5.25" drives. The A register is used to 
indicate the fastest speed capable on the specified drive . Register D is used 
to indicate whether the Motor is always On, or will start and stop periodical- 
jy. This is normal lv used by the Bios to delay for a period before writing if 
the motor is stopped to allow the diskette to come up to speed thereby mini- 
mizing chances of data corruption. Register E is used to indicate the nhys ; - 
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cal media size as : 0=Hard Disk, 001B=.N" Drive. 0i0B=5 . 25" Drive, and 
01 1B=3 . 5" . Nothing is returned from this command. 

While all of these functions may not be supported on any specific compute: 
type, the interface from using programs should always pass the necessary 
parameters for compatibility. 

NOTE: This routine assumes that SubFunction 2 (Set Head and Drive) has been 
called first. Call this routine before calling Function 0 (Set Mode). 


Set Head and Drive 


Exit: None. 


Uses : AF 


Function 31 (xx5D) 
Floppy SubFunction 2 


Enter: A = Drive # (Bits 0,1 ) 
Head # (Bit 2) 

B = 1 (Floppy Driver ) 

C - 2 (Subfunction # ) 


This routine is entered with register A containing the Floppy unit number 
coded in bit- 0 ana ! (Unit 0 --- 00. j - ()i .. 3 = 11). and the Head in Pi t 2 
(0 - Head 0. 1 = Head 1 i . Nothing i returned From this function. Cali the 
Subfunction Ik- fore most of t he others to minimize problem-- in FJopp;, accesses . 


fr" 


ii 

t! 

Ii 
i L 


Function 31 (x:-bD: 

F loopy SubFunctior. 2 


. • v 

Enter: A = Rhys 1 cal Sector Number j Exit: 
D - Physical Sector Size I 
E. - Last Sctr # on Sice | Uses: 
B = 1 (Floppy Driver) 

C = 3 (Subfunction #) 


Set 

None . 

AF 



Floppy Disk Mode j! 

ji 


i 

■—Jj 


This routine establishes information needed to properly access a specified 
sector unambiguously with a number of different controller types. On entry. 
Register A contains the desired physical sector number desired. D contains the 
sector size where 0 = 1 28 byte sectors, 1 = 256 . . 3 = 1024 byte sectors, and 
F. contains the last sector number on a side. Normally register F. is unused in 
Western Digital controllers, but is needed with 765 and 9266 units. Nothing 
is returned from this subfunction. 
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Function 31 (xx5D) 
Floppy SubFunction 4 

Specify Drive Times j 

i 

Enter: A = Step Rate in milliSec 

1 

Exit: None. 

D = Head Unload Time in mS 


E = Head Load Time in mS 

Uses: AF 

B = 1 (Floppy Driver) 


C = 4 (Subfunction #) 



This subfunction set various timing values used for the physical drive select- 
ed. On entry, the A register contains the drive step rate in milliseconds. 
Within the Bios, this rate is rounded up to the nearest controller rate if the 
specified rate is not an even match. Register D should contain the desired 
Head Unload time in milliseconds, and E to the desired Head Load time in mS. 

NOTE: With Western Digital type controllers, only the Step Rate is universally 
variable. In these systems, rates signaled by the Bios settings are rounded 
up to the closest fixed step rate such as the 2. 3. 5, or 6 millisecond rate- 
in the WT)17~2 or 6, 10, 20. or 30 millisecond rates used in the older WD1“"0 
and WD1795. Nothing is returned from this function. 


! Function 31 (xx5D) Home Disk Drive Heads ji 

I Floppy SubFunetton 5 jj 


ji Enter: E = 1 (Floppy Driver; ji Exit: A = 0, Zero Set (Z) if Ok ji 


( C = 5 (Subfunction #} 

j 


A <> 0, 

NZ 

if Errors 

ii 

It 

1 

! 

i Uses: 

AF 



ll 

| 

i 

i NOTE : 

Subfcns 1 , 

2, 

& 4 Needed 

1; 

i; 


This subfunction moves the head(s) on the selected drive to track 0 (home). 
Only success/failure is indicated by the value in the A register. No other 
registers may be altered by this function (especially BC). 

NOTE: This function requires that Subfunctions 1 (Set Disk and Motor Parame- 
ters). 2 (Set Head and Drive) and 4 (Specify Drive Times) be called first in 
order to establish the physical characteristics of the Drive. 
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Function 31 (xx5D) 
Floppy SubFunction 6 

i 

Seek Track 

Enter: A = Desired Track Number 

Exit: A = 0, Zero Set (Z) if Ok 

{ D = OFFH to Verify, 

<> 0, NZ if Error 

j 0 for No Verification 


E = 0 for No Double-Step 

Uses: AF 

<>0 for Double-Step 


B = 1 (Floppy Driver) 

NOTE: Subfcns 2, 3, & 4 Needed 

C = 6 (Subfunction #) 

i 

-3 


This subfunction moves the head(s) for the selected drive to a specified track 
on the media. If the Double-Step flap (Register E) is set to a Non-Zero 
value, then the controller will issue two step pulses for every track incre- 
ment or decrement which is required. After the Seek, a Read ID function will 
be performed to verify that the desired track was found if the Verif icat ion 
flap (Register Di is set to a Non-Zero Number, preferably 0F1TR Only the AT 
registers may be altered by this function. 

NOTE: This function requires that Subfunctions 2 (Set Head and Drivel. 3 (Set 
floppy Disk Mode ) and 4 (Specify Drive Times) be called first in order to 
establish the physical characteristics of the Drive. 


Function 31 (xx50) 
j Floppy SubFunction 7 

Read Floppy Disk Sector i 

1 

j Enter: He = Dest Butter Address 

1 Exit: A = 0, Zero Set (Z) if Ok | 

j B - 1 (Floppy Driver) 

i <> 0, NZ if Error |j 

i C - 7 (Subfunction # ) 

II 

j 

Uses: AF . HL ji 

i 

j 

ii 

i NOTE: Subfcns 0,1, 2, 4 & 6 Needed ji 
i — J 


This subfunction Reads a physical sector of data from the selected drive and 
places it in the buffer at the specified address. It is important that an 
appropriately sized buffer is provided for this task. The Value in the A 
register will indicate the success or failure of the function as indicated in 
the above chart. Only the AT and HL registers may be altered by this func- 
t ion . 

NOTE: This function requires that Subfunctions 0 (Set Read/Write Mode). .1 
(Set Disk k Motor Farms). 2 (Set Head k Drive), 4 (Specify Drive Times) and 6 
(Seek Track) be called first in order to establish the physical and logical 
characteristics of the data transfer. 
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Function 31 (xx5D) 


Write Floppy Disk Sector 


Floppy SubFunction 8 j 

Enter: HL = Source Buffer Address 

~5, 

Exit: A = 0, Zero Set (Z) if Ok j 

B = 1 (Floppy Driver) 

A <> 0, NZ if Error 

C = 8 (Subfunction #) 



Uses: AF,HL 


NOTE: Subfcns 0,1, 2, 4 & 6 Needed 

i 


This subfunction writes data from the buffer beginning at the specified ad- 
dress to the track, sector and head selected by other subfunctions. The value 
in the A register along with the setting of the Zero Flag will indicate wheth- 
er the operation succeeded or not. Only the AF and HL registers may be al- 
tered by this function. 

NOTE: This function requires that Subfunctions 0 (Set Read/Write Mode!, 1 
(Set Disk k Motor Farms). 2 (Set Head & Drive). 4 (Specify Drive Times) and 0 
(Seek Track) be called first in order to establish the physical and logical 
characteristics of the data transfer. 


r — - ■ - ‘ " " ■ ~ - 1 ' 

j Function 31 (xx5D) 

j Floppy SubFunction 9 

Read Disk Sector ID j 

i 

j 

i — .... - ... - || - - - 1 

i Enter: B = 1 (Floppy Driver) 

i Exit: A = 0, Zero Set (Z) it 01 

j C = 9 (Subfunction #) 

! A <> 0, NZ if Error 

1 

1 

i 

i Uses: AF 

I 

1 NOTE: Subfcns 0 & 2 Needed 

i 

11========= — ■ — 

i ........... .1 


This Subfunction reads the first correct ID information encountered on a 
track. There are no entry parameters for this function other than the Driver 
and Subfunction number. A flag is returned indicating whether or not errors 
occurred. An error indicates that no recognizable Sector ID could be read on 
the disk. In most cases, this is due to an incorrect Density setting in the 
Bios . 

NOTE: This function requires that Subfunctions 2 (Set Head k Drive) and 3 
(Set Floppy Disk Mode) are called first in order to establish the physical 
characteristics of the disk. 
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j Function 31 (xx5DJ Return Floppy Drive Status 

j Floppy SubFunction 10 i 

L — _ — — — ji 

Enter: B = 1 (Floppy Driver) 
C = 10 (Subfunction #) 

' 

Exit: A = Status Byte of last Opn | 
BC = FDC Controller Type j 

HL = Address of Status Byte j 

j 

Uses: AF, BC, HL 

NOTE: Subfcn 2 Needed 

_ . . ... 1 


This function returns the status of the currently-selected drive. There arc 
no entry parameters for this function other than the Floppy Driver and Func- 
tion number. On exit, the raw unmasked status byte of the drive, or the last 
operation depending on the controller type, is returned along with a binary 
number representing the FDC controller type (e.g. 765, 9266. 1772. etc). 

NOTE: This routine assumes that Subfunction 2 (Set Head & Drive) has been 
called before this routine to select the Physical Parameters. 


I Function 31 (xx5D) 

I Floppy SubFunction i 1 

~=t 

ji Enter: FiL - Pointer to Data Block! 

j D = # of Sectors/Track j 

! E = # of Bytes in Gap 3 I 

i B = 1 (Floopv Driver) ! 

! C = 11 ( Subfunction #) | 


Format Floppy Disk Track 


Exit: A = 0, Zero Set (Z) if Ok jj 
A <> 0, NZ if Error jj 

ji 

Uses: AF.BC.DE, HL jj 

NOTE: Use Subfcn 10 tor Cent Type'!! 


This Sub i unction 1 or mat s a complete track on one side of a Floppy Disk. It 
assumes that the Mode. Head/Drive. Track, and Sector have already been set. 
On entry. HI. points to data required by the controller to format a track. 
This varies between controllers, so RETDST should be called to determine 
controller type before setting up data structures. On entry, D must also 
contain the number of Sectors per Track, and E must contain the number of 
bytes to use for Gap 3 in the floppy format. On exit. A=0 and the Zero flap 
is Set (Z) if the operation was satisfactorily completed. A <> 0 and the Zero 
flag cleared (NZ) if errors occurred. This routine may alter all primary 
r eg i s t er s i AF . BC , DE . HI, ) . 

NOTE: This routine assumes that Subfunction 10 (Return Floppy Drive Status) 
has been called first to determine the Controller type and insert the correct 
information in the Format Data Block. 
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HARD DISK SUBFUNCTIONS. 

These functions are available to directly access Hard Drives connected by a 
SCSI type interface. They are accessed by loading the desired function number 
in the C register, loading a 2 (SCSI driver) into the B register and calling 
or jumping to Jump number 31 in the Bios entry jump table. Since this intei- 
face is not as standardized as Floppy functions in order to handle SASI as 
well as SCSI devices, the interface has only basic functions with the precise 
operations specified by the User in the Command Descriptor Block passed with 
Function 2. While this places a greater burden on User programs, it allows 
more flexibility to take advantage of changing features in the newer SCSI 
drives. 


r 


i'l 

ii 


Function 31 (xx5D) Set Hard Disk Addresses j 

Hard Disk SubFunction 0 j 

- — — — — —_ —== = — , - - - - ■ = —ji 

Enter: DE = Address of Data Area |i Exit: A = # Bytes in Comnd Block jj 
B = 2 (Hard Disk Driver) ji jj 

C = 0 (Subfunction #) jj Uses: AF j| 


This Sub function sets the User Data Area Address for Direct SCSI Jo. and 
returns the number of by t es available in the SCSI Command Descriptor Block. 
The Data Area must be AT LEAST 512 bytes long and is used to store data to be 
written, and to receive data read from the selected drive. This Data Area 
size is mandatory since 5 i 2 bytes are always returned from a direct access in 
order to handle the wide variety of controller types recognized in the B/P 
Bios driver.".. The number of bytes available in the Command Descriptor Block 
within the physical driver is usually 10 in order to handle the ex t ended SOS 1 
commands, but may be scaled back to c in 1 indited applications. 


) 

j Function 31 (xx5D) 

| Hard Disk SubFunction 1 

Set Physical & Logical Drive | 

j 

1 

i Enter: A = Device Byte (5.2.1) 

1 Exit: A = Physical Device Bit 

j B = 2 (Hard Disk Driver) 


j C - 1 (Subfunction #) 

i — — 

j Uses : AF 


This Subfunction sets the Physical Device bit in the Bios for SCSI accesses 
and the Logical Unit Number in the SCSI Command Block (Byte 1, bits ~-5). The 
format of the Device Byte provided to this routine is defined in the Configu- 
ration Data. Section 5.2.1. C0NFIG+61, and is available from the Extended Disk 
Parameter Header at DPH- 1 . On exiting this routine, a byte is returned with a 
’’One” bit in the proper position (Bit 7 = Device "...Bit 0 = Device 0 1 to 
select the desired unit via a SCSI command . 
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Function 31 (xx5D) 

Hard Disk SubFunction 2 

l 

— — ■ -- == " ~~ li 

Direct SCSI Driver , 

j Enter: DE = Ptr to Comnd Desc Blk 

Exit: A = Bitl Status, Flags Set 

A = 0 i f No Wri te Data 

H = Message Byte Value 

| A = FF if Data to Write 

L = Status Byte Value 

j B = 2 (Hard Disk Driver) 


j C = 2 (Subfunction #) 

Uses: AF,BC,DE,HL 

i 

i 

NOTE: Subfcns 0 & 1 Needed 




This Subfunction performs the actions required by the command in the specified 
Command Descriptor Block. The flag provided in Register A signifies whether 
or not user data is to be wi itten by this command. If set to a Non-Zero 
value. Data from the area specified with Function 0 will be positioned for 
SCSI Write operations. At the end of the routine. 512 bytes are always trans- 
ferred f roii: the Bios 10 Buffer to the Users Space set by Subfunction 0. This 
may bo inefficient, but was the only way we could accommodate the wide variety 
of different SAS1 /SOM cont rollers within reasonable code constraints. The 
status returned at comp let ion of this function is the Status byte masked with 
the Check Bit. Bit j. The fin I Status Byte and Message Byte from SCSI opera- 
t ions are a i so provided tor more definition of any errors. 

NOTE: This rout ine assume.- that the command Descriptor Block has been properly 
configured 1 or the type of Hard Disk Controller set in B/P Bios, and that the 
selected disk is properly described tit necessary ) in the Bios Unit defini- 
tions. Errors in phasing resuit in program exit and Warm Boot. It assume s 
the user has called Functions 0 (Set Hard Disk Addresses) and i iset Physical 
k Logical Drives ) before using this Subfunction. 


if 

l; 

il 


il 


It 


Function 32 (xxoO) Set Bank for Far Jump/ Cal 1 ]i 


Enter : 

A. - Desired Bank Number 

! Exit: 

None . 



Uses : 

No Registers 


This Function sets the bank number for a later Function 33 Jump to a routine 
in an alternate Memory Bank. 
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II Function 33 (xx63| 


Jump to (HL) in Alternate Bank 


Enter: HL = Address to execute 

in Bank set w/Fn 32 


Exit: <Unknown> Called routine 
sets return status 
Uses: All Primary Regs (assumed) 


This Function switches to the bank number previous 1}- specified with Function 
32, then calls the routine addressed by HL. Upon completion, operation re- 
turns to the bank from which called, and the address on the top of the stack. 


i p = = =========== = ==== = 

l! Function 34 (xx66) 

|r 

ll Enter: HL = Addr to resume exec || 
1 in entry bank I 

tt li 


Clear Stack Switcher ft 


Exit: None. Execution resumes || 
at addr in HL in entry bank i| 
Uses: No Registers jj 


This Function is used for error exits from banked routines to return to the 
entry bank. 


r — ' 

j Function ; 

35 (xx69) 

Load A,(HL) from; Alternate Ban! 

ii 

V 

j Enter: HL = 

= Addr of 

desired byte i| Exit: A - Byte trot: C:HL 



C = Desired Ban! Number 


Uses: AF 


This Function pets a byte (j-hit; > from the specified Bank and Address. The 
bank is temporarily switched in context for the access (if required) , thou 
restored to entry condition:. Interrupts are temporarily disabled dur in? the 
brief access time. 


lr= 

i 

t_ 

Function 

36 (xx6C) 

Load DE,(HL) from 

Alternate Bank 

j; 

ii 

!! 

r~ 

I 

Enter: HL 

= Addr of 

, r 

desired word |! 

Exit: 

DE = Word 

from C:HL 

II 

1! 

1 

C 

- Desired 

Bank Number t| 




II 

1 



II 

JL 

Uses : 

AF,DE 


ii 

J; 


This Function pets a Word (ld-bits) from the specified Bank and Address. The 
bank is temporarily switched in context for the access til required), then 
restored to entry conditions. Interrupts are temporari iy disabled dur in? the 
brief access time. 
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Function 37 (xx6F) 

Load ( HL } , A to Alternate Bank 

Enter: HL = Addr of Dest Byte 

Exit: None. Byte stored at C:HL 

C = Desired Bank Number 


J A = Byte to save at C:HL 

Uses: AF 


This Function saves a Byte (S-bits) to the specified Address and Bank. The 
bank is temporarily switched in context for the access (if required), then 
restored to entry conditions. Interrupts are temporarily disabled during the 
brief access time. 


Function 38 (xx72) 


Load (HL),DE to Alternate Bank 


Enter: DE = Word to store at C:Hi_j Exit: None. 

HL = Addr of Dest Word i 

C = Desired Barns Number j Uses: AF 


Word stored at C:HL 


This Function saves a Word . In-bit s 1 to the specified Address anti Bank . The 
bank .is temporarily switched in context for the access (if required), then 
restored to entry condition , Intel rum s are temporarily disabled during the 
brief a-: c -. time. 


ii Function 39 t zx?5 } 
Ii Enter: Nor.e 

I 

| 


Return Current Bank in Context ji 

j| Exit: A = Bank currently active ji 

i in Addr 0. . 7FFFH j; 

ji Uses: AF ii 

Ji.... j; 


This Function returns the Memory Bank currently in Context in the address 
range of 0..TTTH. It may be used in the 'where am I" role in application 
programs to track memory accesses. 
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5.2 Bios Data Structures. 
5.2.1 Conriguration Area. 


Much of the ability to tailor R/P Rioses to your specific operating needs is 
due to the standardized location of many discrete elements of data, and a 
facility to easily locate and change them, regardless of the particular hard- 
ware platform in operation. Bios Function 30, Return Bios Addresses, reports 
the base address of the Configuration Area in the DE register pair. In this 
section, we will review each of the specified elements, their functions, and 
which parts of the data must be rigidly controlled to insure that the supplied 
utilities continue to function, as well as guarantee the portability of other 
programs . 


CON FIG-6 - Bios ID. Character String, 6 bytes. 

This character string MUST begin with the three characters "B/P in Uppercase 
Ascii, followed by three Version-specific identifying characters. As of March 
1993, the foi lowing identifiers have been assigned to systems: 


"B/P-YS" 

"B/P-AM" 

"B/P-18" 

"B/P-CT" 

"B/P-TT" 

"B/P-XL" 


YASREC 

Ampro Little Board 100 
MicroMint SB- 180 
Compu/1 ime Si 00 Board Set 
T e 1 o t e r 

intelligent Computer Designs Xl-Mlsu 


C0NFIG+0 - IOBYTE. Byte. 

This byte contains the initial definition of the byte placed at off set 3 on 
the Base Page ( 0003U i during a Co 1 d bom and determines which of the ioui 
defined character 10 devices v, i i i oe used as the Console. Auxiliary and Print- 
er devices. The default setting may be altered by BPC'sEG to reflect changed 
device configurations, or by reassembly of the Bio-.. 

The bit definitions in this byte art: 


Bit 7 6 5 4 3 2 1 0 



Console Device 
Auxiliary Input Device 
Auxiliary Output Device 
Printer Device 


CONFIG+1 - System Drive. Byte. 

This byte contains the drive which will be accessed after a Cold Boot and is 
assumed to contain the Operating System files. It is a binary value where A - 
0. B = 1 . . .P = 15. 
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CONFIG+2 - Bios Option Flags. Byte. 

This byte consists of individual Jy mapped bits which display which options are 
active in the assembled Bios. The bits listed as <reserved> should not be 
defined without prior coordination with the system developers to preclude 
conflicts with planned enhancements. The byte is currently defined as: 


Bit 7 6 5 4 3 2 1 0 



0 = Unbanked Bios 
0 = Bank in RAM 
0 = DPBs Fixed 
0 = ALV/CSV in TPA 
< reserved? 


1 = Banked Bios 
1 = Bank in ROM 
1 = DPBs Assignable 
1 = ALV/CSV in Bank ( ZSD0S2) 


The next five bytes define the memory map of a banked system in 32k slices. 
For a complete description of Bank allocations, please refer to Section 4. In 
non-bank ed system-, all except the RAM Drive Bank should all be set to 0. If 
no memory is available for re-assignment as a RAM drive, this byte as we) i 
should be set to 0. 

CONFIG+3 - User Bank. Byte. 

This Byte reflect s the Rank number reserved for User Applications. 

CONFIG+4 - TPA Bank. Byte. 

This Eyre reflects the Bank number reserved for the Transient Program Area in 
the address range, ol U..7HH1. The next sequential bank number is normally 
the Common Bank which always remain in Context in the addressing ranee of 
8000. .FFFFH and contains tin ''aerating System. Bios and /.-System tables. 

CONFIG+5 - SYStem Bank. Byte. 

This byte reflects t he- Bank number containing any executable code- and data 
specified for the System bar 1 . 

CONFIG+6 - RAM Drive Bank. Byte. 

This byte reflects the starting Bank number available for use as a RAM Drive. 
It is assumed that ail TAM from this Bank through trie Maximum Bank Number i; 
contiguous anti avail ah In as a RAM Drive . 

CONFIG+7 - Maximum Bank Number. Byte. 

This byte reflects the number of the last available bank of RAM in the system. 
In many systems, it may be set to di i ferent numbers depending on the number of 
RAM chips installed in the system. 

CONFIG+8 - Common Page Base. Byte. 

This byte rei lects the Base Page of the Common area in systems which do not 
fully comply with the 32k Memory Banking architecture of B/P Bios, but can be 
made somewhat compliant. This Byte must be AT LEAST 80H, but may be higher if 
needed. 

CONFIG+5 - DPB Size. Byte. 

This byte contains the length of Disk Parameter Block allocations within the 
bios. Since more information is needed than the 15 bytes defined by Digital 
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Research in CP/M 2.2, an extended format is used. All re-assignments Of Disk 
Parameter data should use this byte to determine the size of records. 

CONFIG+IO - Number of DPBs in Common RAM. Byte. 

CONFIG+11 - Number of DPBs in System Bank.. Byte. 

These two bytes indicate the complete complement of Floppy Disk formats avail- 
able within the Bios. In most cases, one of these two bytes will reflect a 
zero value with all Disk Parameter Blocks resident either in the Common area 
or in the System Bank. The provisions are available, however with these two 
bytes to split the definitions for custom versions without voiding the support 
tools provided. 

CONFIG+12 - Pointer to first Common DPB. Word. 

CONFIG+14 - Pointer to first Banked DPB. Word. 

These two words point to the first DPB in a sequential list within the respec- 
tive memory banks for Disk Parameter Blocks defined in the preceding bytes. 
In most cases one of these two words will be a Null pointer ( OOOGH ) corre- 
sponding to no data as described in the count bytes above. 


CONFIG+16 - Initial Startup Command. String. 

This string contains the first command which will be initiated on a Cold Boot . 
It i s loaded into the Multiple Command Buffer defined in the Environment 
Descriptor (See 5.2.4) and calls a file of the specified name with a type of 
'COM". The string may have up to eight characters and must be Null-terminated 
( end with a F-i nary 0). The string is defined as: 

Byte - Number of Characters (0..S) 

String - 8 bytes fo r Ascii characters (usually Uppercase) 

Byte - Terminating Null (binary 0) 

CONFIGH26 - Pointer to Environment Descriptor. Word. 

This Word points to the first byte of an extended Z34 Environment which MUST 
begin on a Page boundary ( xxOOH i . See Section 5.3.1 for a complete descrip- 
tion of the Environment Descriptor and B/P Bios unique features. 

CONFIG+28 - Banked User Flag/Bank Number. Byte. 

This Byte may be used as a f ia? to indicate whether or not a User Bank is 
defined. Bank 0 cannot be used as a User bank by decree of the system au- 
thors. Therefore, if this byte contains a binary 0, no User Bank is avail- 
able. 

CONFIG+29 - Pointer to Start of Banked User Area. Word. 

This word contains the address of the first available byte in the Banked User 
Area, if one exists. Routines loaded into the User Bank should contain a 
standard RSX header structure to link sequential programs and provide a primi- 
tive memory management function. 

CONFIG+31 - CPU Clock Rate in Megahertz. Byte. 

This byte must contain the processor speed rounded to the nearest Megahertz. 
It may be used by software timing loops in application and utility programs to 
adapt to the clock speed of the host computer and provide an approximate time. 
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This byte is reflected in the Environment Descriptor (see 5.2.4) as well for 
programs which are 7-System "aware' . 

CONFIG+32 - Additional Wait State Requirements. Byte. 

This bvte is "nibble-mapped" to reflect the number of wait states needed for 
memory and 10 accesses when these functions can be set via software. In the 
Z80/Z1S0. 10 port accesses have one wait state inserted within the processor. 
This byte does not account for this fact, and reflects wait states IN ADDITION 
TO any which are built into the hardware. For older processors such as the 
780, these bytes normally have no effect since additional wait states must be 
added with hardware. 

CONFIG+33 - Timer Reload Value. Word. 

In many systems. Interrupts or Timer values are set by software-configurable 
countdown timers. the lb-hit value at this location is reserved for sett ire 
the timer value and may be "fine tuned' to allow the system to maintain cor- 
rect time in the presence of clock frequencies which may deviate from precise 
frequencies needed for accurate clocks. 

CONF1G+35 - Floppy Disk Physical Parameters. Table. 

This table consists of four 5 -byte entries which contain information on up to 
tour physical drives, bach entry is defined as: 

Byte 0 - Provides base for XDPU byte. Bit mapped as: 

Disk Size 000=Fixed Disk, 001=8", 010=5.25”, 011=3.5" 

0 = Single-Sided, 1 = Double-Sided 

< reserved > 

0 = Motor Always On 1 = Motor Control Needed 

0 = 300 RPM Max Speed 1 = 360 RPM (8" & HD) 

<reserved> 

Byte 1 - Step Rat. in mill i seconds. 

Byte 2 - Head Load Time in milliseconds. 

Byte 3 - Head Unload Time in mill i. seconds. 

Byte 4 - Number of Tracks (Cylinders) on drive. 

Those bits in Byte 0 which are listed as unused must be set to 0 since this 
byte provides the initial value stored in the XDPH when assignable drives arc- 
used . For controllers which do not need the available information (e.g. 
Western Digital controllers do not need Byte 3), these values may be set to 
any arbitrary value, but MUST remain present in the structure to prevent 
changing subsequent addresses. 

CONFIG+55 - Motor On Time in 1/10th Seconds. Byte. 

This time may be used in some types of Floppy Disk controllers to keep the 
drive motors spinning tor a specified time after the last access to avoid 
delays in bringing the spindle up to speed. Some controllers, notably the 
Western Digital l~xx and lvxx series to not support this feature. In this 
case, the byte may be set to any arbitrary value, but MUST remain present. 
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CONFIG+56 - Motor Spinup Time in 1 /10th Seconds. Byte. 

This time is the delay which will be imposed by the Eios before attempting to 
access a Floppy Disk drive when it senses that the motor is in a stopped 
condition. Providing such a delay will minimize the probability of data 
corruption by writing to disk which is rotating at the incorrect speed. 

CONFIG+57 - Maximum Number of Retries. Byte. 

This byte specifies the number of attempts w’hich will be made on a Floppy Disk 
access before returning an error code. In some cases, such as diagnostic 
programs, it may be desirable to set this value to 1 to identify soft errors, 
or ones which fail on the first attempt, but succeed on a subsequent try. We 
recommend a value of 3 or 4 based on our experience. Larger values may result 
in inordinately long delays when errors are detected. 

CONF1G+58 - Pointer to Interrupt Vector Table. Word. 

This Word contains the address of the base of an Interrupt Vector Table which, 
when used, contains pointers to service routines. The precise definition of 
the table is not standardized and may vary considerably between systems. This 
pointer serves only to provide an easy and standardized method of locating the 
table for re-definition of services or system features. 


CONF1G+60 - SCSI Controller Type. Byte. 

To accommodate the widest variety oi diiierent controllers including the older 
SASI models, this byte is defined as containing a byte code to the specific 
model being used. In most cases, ibis byte has little if any effect within 
the Bios, but may have- significant effects on Hard Disk Diagnostic programs, 
or User-developed utilities. Any additions to tins table should be coorui bat- 
ed with the authors to insure that the standard support utilities continue to 
fun c t i on . Cu rrent definitions are : 


0 - Ow j 

1 - Adaptec ACR-4000Z 

2 - Xebec 14 10A/Shugari 1 0 1 0-3 :SASI) 

3 - Seagate SCSI 

4 - Shugart l Pi 0-4 (Minimal SCSI subset } 

5 - SCSI-2 ( Newer Conn- • t . quantum and Maxtor drive si 
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CONFIG+61 - Hard Drive Physical Parameters. Table. 

This table consists of three 4-byte entries defining up to three physical Hard 
Drives. While the SCSI definition allows for more units, three was considered 
adequate for most systems. If additional drives are needed, please contact 
the authors for methods of including them without invalidating any of the 
standard utilities or interfaces. Each of the three entries is defined as: 

Byte - Physical and Logical Address as: 

Bit 7 6 5 4 3 2 1 0 

Physical Device (000-110B, 111B reserved for Host) 
<reserved> 

0 = Drive NOT Present, 1 = Drive Present 
Logical Unit Number (000-11 IB) for controllers 
capable of handling multiple drives 

Word - Number of Physical Cylinders on Drive 
Byte - Number of Usable Physical Heads on Drive 
Word - Cylinder Number to begin Reduced Write Current 
Word - Cylinder Number to begin Write Precompensation 
Byte - Step Rate. This byte may either be an absolute rate in mS or a 
code based on controller-specific definitions 

For many of the never controllers, the last three items may not have any 
meaning in which case they can lv set to any arbitrary value. Also in newer 
drives, the physical characterist ics such as the number of cylinder: 1 and heads 
may be hidden within the drive electronics with re-mapped values provided to 
the controller via various SOS l commands. As with the last three entries, in 
th s case, t hey m; \ he set to any arbitrary value. 

CONFiU+88 (Reserved Bytes). live Bytes are reserved for future expansion. 

CONF1G+93 - Character Device Definitions. Table. 

This table consist., of four or more- I ('-byte (8-byte in B/P versions, prior to 
i.i) entries and must be terminated by a Null (binary Zero) byte. Each entrv 
define the name and characteristics of a character device in the system. The 
first jour of these are directly available lor seiection by the I0HYTE as the 
Console. Auxiliary ]0 and Printer. Other entries may be defined and exchanged 
with the first lour to make them accessible to the system. The entries are 
defined as: 

String - Four Ascii character Name as: COM1 , PI01, NULL, etc. 

Byte - Data Rate capabilities as: 

Bit 7 6 5 4 3 2 1 0 

Current Data Rate Setting 

Maximum Rate Available (Bits-per-Second) as: 


0000 = None 

0001 

= 134.5 

0010 = 50 

0011 = 75 

0100 = 150 

0101 

= 300 

0110 = 600 

0111 = 1200 

1000 = 2400 

1001 

= 4800 

1010 = 9600 

1011 = 19200 

1100 = 38400 

1101 

= 76800 

1110 = 115200 

1111 = Fixed 
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Byte 


- Configuration Byte defined as: 

Bit 7 6 5 4 3 2 1 0 


0=2 Stop Bits, 1 
0 = No Parity, 1 
0 = Odd Parity, 1 
0 = 8-bit Data, 1 
0 = No XON/XOFF , 1 
0 = No CTS/RTS , 1 
0 = Device NOT Input, 1 
0 = Device NOT Output, 1 


1 Stop Bit 
Parity Enabled 
Even Parity 
7-bit Data 

XON/XOFF Control Enabled 
CTS/RTS Control Enabled 
Device can be read 
Can Write Device 


Byte - Input Data Mask. Bit-mapped byte used to logically AND with 
bytes read from Device Input. 

Byte - Output Data Mask. Bit-mapped byte used to logically AND with 
bytes before being output to device. 

Word - Pointer to Character Output routine. 

Word - Pointer to Output Status routine. 

Word - Pointer to Character Input routine. 

Word - Pointer to Input Status routine. 


NOTE: The last four pointers are not at these locations in B/P bios versions 
prior to 1.1. but were accessed by a pointer returned by Bios function 3u. 


5.2.2 Disk Parameter Header. 

The Disk Parameter Header (DPii) is a logical data structure required foi each 
disk drive in a CP/M compatible Disk Operating System. It consists of a 
series of eight pointers which contain addresses ol other items needed by the 
DOS as well as some scratchpad space. The Address of the DPH associated with 
a given drive is returned by the Bios alter a success! ui selection with Bios 
Function 9. If Errors occur during selection, or the drive does not exist, a 
Null Pointer (OOOOH) is returned. 

for B/P Bios, it was necessary to add an additional four bytes to each DPH 
which contain additional information on physical and logical parameters a-, 
well as flag information. These additional bj r tes are referred to as the 
Extended DPII. or XDPli. While similar in concept to the extension added to 
CP/M 3. the implementation is different. The XDPH prepends the DPH and may be 
accessed by decrementing the returned address. As a convention. DPHs in B/P 
Bios source code have reserved certain label sequences for specific types of 
units with DPH00-DPH49 used for Floppy Drives, DPH50-DPH89 for Hard Drive 
Partitions and DPH90-DPH99 for RAM Drives. 

An entire DPH/XDPH block is required lor each logical drive in a B/P Bios 
system. While some pointers, such as the pointer to the Directory Buffer, may 
be common across a number of drives, lor most systems, the other items will 
point to unique areas. 

The DPH/XDPH elements as indexed from the DPH addresses accessible to applica- 
tion programs are: 


no 
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DPH-4 - Format Lock Flag. Byte. 

A Zero value indicates that the format of the disk is not fixed, but may be 
changed. If the Bios was assembled with the Auto-select option, the Bios will 
scan a number of different formats in order to identify the disk. If a OHli 
value is placed in this byte, it indicates that the format is fixed and cannot 
be changed. This is normally the case for RAM and Hard disk drives, as well 
as for alien floppy formats which have been selected in the emulation mode. 
If the Auto-select option was not chosen during assembly of the Bios, ail 
Floppy bisk drives wj j i also have a OFFH byte in this position showing that 
the formats cannot be changed. 

DPH-3 - Disk Drive Type. Byte. 

This byte is bit mapped and contains flags indicating many parameters of the 
drive. For Floppy Drives, this byte contains a copy of the first byte in the 
Physical Drive Table (See 5.2.1, COM'iG+35 ) with the two reserved bytes set 
during the drive selection process. The byte is then defined as: 


Drive T ype Byte 


Bit 7 6 5 4 3 2 1 0 



Disk Size 000=Fixed Disk, 001 
0 = Single Sided 
0 = Single Step Drive 
0 = Motor Always On 
0 = Max Speed 5.25" (300 rpm) 

0 - Double Density 


=8", 010=5.25", 011=3.5" 

1 = Double Sided 
1 = Double Step Drive 
1 = Drive Motor Control Needed 
1 = 8" i HD Max Speed (360 rpm) 
1 = Single Density 


for Hard Disk Partitions and the PAM Drive, this byte is not used and is set 
to all Zero:'- indicat ing a fixed Drive type. 

DPH-2 - Driver ID Number. Byte. 

Ihree Driver Types are used in the basic B/P Bios coni igurat ion . A Zero value 
indicates a Non-existent driver, with other values used to direct disk access- 
es to the respective code appropriate to the device. Basic del inert driver 
types exist i or 1 i opp\ Disk * i .• . Hard Disk via the SCSI interface (2). and RAM 
I ’ i s k (.">). I : you wish to extend this table to include tailored drivers . 
piease consult with the authors to preclude possible conflicts with planned 
extens i ons . 

DPH-1 - Physical Drive/Unit Number. Byte. 

this byte contains the Physical Drive or Unit Number hosting the logics; 
drive. for Floppy Drives, this wj li usually be in the range of 0 to 3 for 
lour drives. Hard drives mat - have several DPHs sharing the same physical 
drive number, while this field is ignored in the single RAM drive supported in 
the distribution B/P bios version. 

NOTE: The Physical Drive Number byte for Hard Drives is comprised of two 
fields to ease handling of SCSI devices. Up to seven devices (device 1 1 IB is 
reserved for the Host Computer) each having up to 8 Logical Units may be 
(<ef inert. The Byte is coni i cured as: 
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Physica l Drive Number 


Bit 7 6 5 4 3 2 1 0 



Physical Device (000-110B, 1 1 1 B reserved for Host) 
<reserved> 

0 = Unit Not Available, 1 = Unit Active 
Logical Unit Number (000-111B) 


DPH+0/1 - Skew Table Pointer. Word. 

This word contains a pointer to the Skew table indicator. It rarely is used 
for Hard and RAM drives, but is required in Floppy Disk drives. If the Bios 
was assembled using the Calculated Skew option, the address is of a Byte whose 
absolute value indicates the numerical value of skew (normally in the range of 
1 to 6) used for disk accesses. This term is often replaced with Interleave, 
and is synonymous for this purpose. If the value of the byte is negative, it 
means that the sectors are recorded in a skewed form on the disk and that 
Reads and Writes should be sequential. If the value is positive, then an 
algorithm is called to compute a physical sector number based on the desired 
logical sector and the skew factor. For systems assembled without Calculated 
skew, this word points to a table of up to 26 bytes which must be indexed with 
the desired Physical Sector number (0.. Maximum Sector Number) to obtain the 
Corresponding Disk Sector number. 

DPH+2 - Dos Scratch Words. 3 Words. 

These three words are available lor the Dos to use as it require 1 -. No fixed 
values are assigned, nor are meanings tor the data stored there of any value. 

DPH+8/9 - Directory Butter Pointer. Word. 

This word points to a j 28-byte Data area that is used tor Directory searches . 
It is usually a common area to a i i BPH's in a system and is frequently updated 
by the Dos in normal use. 

DPH+10/1 I - DPB Pointer. Word. 

This word points to another data structure which details many of the logical 
parameters of the selected drive or partition. its structure is detailed in 
Section 5.2.3 below. Drives of the same type ana logical configuration mar 
share DPB del ini t ions . so it is not uncommon to find the DPB pointers in 
different DPH structures pointing to the same area. 

DPH+12/13 - Disk Checksum Buffer. Word. 

This word points to a scratch RAM buffer area for removable-media drives used 
to detect disk changes. Normally this feature is used only for F loppy Disk 
Drives, and is disabled by containing a Zero word (000011) for Hard and RAM 
drives. For Floppy Drives, a RAM area witn one byte for every four directory 
entries (128-byte sector) is needed (See 5.2.3. DPH+11/12). This scratch area 
c anno t be share cl among dr i v e s . 

It should be noted that m a fully Banked B/P Bios system with ZSDOS2 . the 
Checksum Buffer is placed in the System Bank and not directly accessible by 
applications program: . 



B/P BIOS 


PROGRAMMING 


DPH+1 4/1 5 - Allocation Vector (ALV) Buffer. Word. 

This word points to a hit-mapped butter containing one bit for each allocation 
block on the subject drive (See 5.2.3. DPR+5/P). A 1 bit in this buffer 
means that the corresponding block of data on the device is already allocated 
to a file, while a "0" means that the block is free. This buffer is unique to 
each logical drive and cannot be shared among drives. 

It should be noted that in a fully Banked B/P Bios system with ZSDOS2, the ALY 
Buffer is placed in the System Bank and not directly accessible by applica- 
tions programs. Since access to the ALV buffer is frequently needed to comp- 
ute free space on drives. ZSDOS2 contains an added function to return disk 
free space. Using this ca i 1 allows applications access to the information 
without directly accessing the data structure. 


5.2.3 Disk Parameter Block. 

The Disk Parameter block (DPB! is a data structure defined by Digital Research 
for CP/M which defines the logical configuration of storage on mass storage. 
It has been expanded in B/P Bios to include additional information to provide 
enhanced flexibility and capability. The expansion is referred to as the 
Extended DPB or XDiti . and prepends the actual DPB structure. The address of 
the DPB may he obtained from the DPH pointer returned by the Bios or Dos after 
a disk selection (See 5.2.2 above). All DPBs reside in the Common Memory area 
anci are available to applications programs whether in a Banked or Unbanked 
system, for the sake of a convention, the DPBs are labeled in the same mannei 
as DJ'ils with !iPh0k-l.>P.B4b used for ( loppy Drives. DPB50-DPB.3P for Hard Drive 
Part it ions, and DPbuu-qu for RAM Drives. 


The layout of the Disk Parameter Block as indexed from the available PPt: 
point o r is: 

DPB-16 - Ascii ID String. 10 Bytes. 

‘ibis string serves as an identification which may be printed by applications 
programs such as our BPEORMAT . This string may be a mixed alphanumeric Ascii 
set of up to ten character?., but the last valid character must have the Most 
Significant Bit (Bit ' i Set to a 1". 


DPB-6 - Format Type Byte 0. Byte. 

This byte contains some of the information about the format of the drive, anci 
the logical sequencing of information on the physical medium. The bits in tne 
byte have the following significance: 


Bit 


7 6 5 4 3 2 1 0 



Disk Size: 000 = Fixed Disk, 001 = 8", 010 = 5.25", 011 

Track Type 

000 = Single Side 001 = Reserved 

010 = Sel by Sec, Cont 011 = Sel by Sec, Sec # Same 

100 = SO fill, SI All 101 = SO All, SI All Reverse 

110 = Sel by Trk LSB 111 = Reserved 

0 - Track 0 Side 0 is Double Density, 1 = Single Density 
0 = Data Tracks are Double Density, 1 = Single Density 
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For Hard Drives and RAM Drives, this byte contains ai! Zero bits to s 1 . 2 n 1 .iv 
Fixed Media and format. 


DPB-5 - Format Type Byte 1. Byte. 

This byte contains additional information about the format of information. 
The bits have the following meanings: 


Bit 


7 6 5 4 3 2 1 0 



Sector Size: 000 = 128, 001 = 256, 010 = 512, 011 = 1024 

Allocation Size: 000-1K, 001=2K, 010=4K, 011=8K, 100=16K 

(NOTE: This should match the definition in OPH) 
<Reserved> 

0 = Normal Speed (300 rpm) 

1 = 8” & HD Floppy (360 rpm) or Hard Drive 


For Hard Drives. The distribution 
utilities assume that the Sector size 
should be set as indicated. 


version of B/P Bios and the support 
is always 51 j bytes. The remaining bits 


DPB-4 - Skew Factor. Byte. 

This byte is a signed binary value indicating the skew factor to be used 
during format. Read and Write It is normally used only with F loppy Drives 
and usually set to - 1 (OFF}!) for Hard and RAM drives to indicate that Reacts 
and Writes should be done with No skew. II the option to calculate skew is in 
effect during Bios assembly, the Skew pointer in the DPH (BMt+0/1) points to 
this byte. If a skew table is used, this byte has no effect and snoulci be- set 
to (SO H. 

DPB-3 - Starting Sector Number. Byte. 

This byte contains the number oi the first Physical Sector on each track . 
Since most Disk operating Systems, use a Zero-based sequent ial scheme to refer- 
ence sectors, this value provides tne initial offset to correct logical to 
phys i ca 1 sec t or numbe rs . 

DPB-2 - Physical Sectors per Track. Byte. 

This byte contains the number of Physical (as opposed to logical i Sectors on 
each track. For example. (.’P/M computes sectors based on 1 28-byte a 1 local ion* 
wnich are used on single- densi tv 8 Floppy Disks. One of the popular live- 
inch formats uses five lk physical sectors which equates to 40 logical CP/M 
sectors. This byte contains 5 in this instance for the number of lk Physical 
Sectors . 

DPB-1 - Physical Tracks per Side. Byte. 

This byte contains the number of Physical Tracks per Side, also called the 
Number of Cylinders. It reflects the Disk, as opposed to the Drive capabili- 
ties and is used to establish the requirements for double-stepping of Floppy 
Drives. In the case of a 40-track disk placed in an 80-track drive, this byte 
would contain 40. while the Drive parameter in the Configuration Section 
contains 80 as the number of tracks on the drive. This byte has no meaning 
for Hard Drive partitions or RAM drives and should be set to Zero, although 
any arbitrary value is acceptable. 
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DPB+O/1 - Logical Sectors per Track. Word. 

This value is the number of Logical 128-byte sectors on each data track of the 
disk. It is equivalent to the number of Physical Sectors times the Physical 
Sector Size MOD 128. 

DPB+2 - Block Shift Factor. Byte. 

DPB+3 - Block Mask. Byte. 

DPB+4 - Extent Mask. Byte. 

These three bytes contain values used by the Operating System to compute 
Tracks and Sectors lor accessing logical drives. Their values are detailed in 
various references on CP/M and ZSDOS programming and should not be varied 
without knowledge of their effects. 

DPB+5/6 - Disk Size (Capacity). Word. 

This Word contains the number of the last allocation block on the drive. It 
is the same as the capacity in allocation blocks - 1. For example, if 4k 
allocation blocks are being used and a 10 Megabyte drive is being defined, 
this word would contain 10.000.000/4000 - 1 or 2499. 

DPB+7/8 - Maximum Directory Entry. Word. 

This Word contains the number of the last Directory Entry and is the same as 
the Number of Entries - !. For example, if 1024 directories are desired, this 
word would be set to 1024 - ! = 1023. 

DPB+9/10 - Allocations 0 and 1. 2 Bytes. 

These two Bytes hold the initial allocations stored in the first two bytes of 
the AI.V Buffer (See 5.2.2. DPH+14/15 » during initii. drive selection. Their 
primarv use is to indicate that the Directory Sectors are already allocated 
and unavailable tor data storage. They are bit-mapped values ana are used in 
lli-bytc. Lo-byte form as opposed to the normally used Lo-byte, Hi -byte storage 
used in ZS0 type CPI's for Worn storage. The bits are allocated from the MSB 
of the first byte thru the LSb. then MSB thru LSB of the second byte based on 
one bit per ai location block or fraction thereof used by the Directory. The 
bits may be calculated by t irst computing the number of entries per allocation 
block, then dividing the desired number of entries by this number. Any re- 
mainder requires an additional allocation bit. 

For example, if 4k allocation blocks are used, each block is capable of 
4095/32 bytes per entry = 128 Directory Entries. If 512 entries are desired, 
then 512/128 = 4 allocation blocks are needed which dictates that Allocation 
byte 0 would be llllOUOOB (Of- OH) and Allocation Byte 1 would be 00000000B. 

DPB+1 1/12 - Check Size. Word. 

This Word is only used in’ removable media (normally only Floppy Drives) ant- 
indicates the number of sectors on which to compute checksums to detect 
changed disks. It should be set to 0000H for Fixed and RAM Disks to avoid the 
time penalty of relogging after each warm boot. 

DPB+1 3/ 14 - Track Offset. Word. 

This Word indicates the number of Logical Tracks to skip before the present 
DDL is effect iv». . It is normally used to reserve boot tracks (usually i to 
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3). or to partition larger driven into smaller logical units by skipping 
tracks used for other drive del in it ions. 


5.3.1 Environment Descriptor. 

The Environment Descriptor, referred to as simply the ENV. is the heart of 
what is now known as The Z-Svstem. The most recent additions to the system by- 
Joe Wright and Jay Sage replaced some relatively meaningless elements in the 
ENV with system dependent information such as the location of the Operating 
System components. Consequently, the ENV is not just a feature of the ZCPR 
3.4 Command Processor Replacement, but is an Operating System Resource which 
ai low's other programs such as ZCPR 3.4 to access its information. 

The B/P Bios requires an ENV to be present, and uses several items of informa- 
tion contained in it. The banked ZSD0S2 and Z40 Command Processor Replacement 
use even more ENV features. A few remaining bytes have been re-defined for 
support to B/P Bi os-based systems. To denote the definition of B/P Bios data 
elements, a new Type. hOH. has been reserved. Using this "Type byte, user- 
programs can access and take advantage of the new definitions and features. 

A template for the .Environment Descriptor used in B/P bios which takes its 
values from the Z3BA.SF.iJ!.' file included in the distribution disk is: 

******** * * * * * * * * * * * * * * ** | ' \ [1 *{ j (_) ******** * * * * * * * * * * * * * * * >’ * 

* J f transit ion ins from an older operating environment which * 

* uses user- loaded Environment files such as SYS. ENV. you must * 

* either delete sue 1 ' load instructions or modify the ENV files * 


* to 

reliect the 

EXACT 1 oaded sys t era definition. 

* }■ a i 

Jure to observe this fact wail prooably cause many 

* undes i red side 

et 1 ect s 1 

V f. * sj: V 

* *■ * * S * 51 ¥ * * 5* 

>;. * >. * * * * * a * * * * * > * * * * * * * * * * * * * * * * * * * * * * * * 

ronment 

Descriptor for 

ZCFRZ4 

JF 

0 

, Leading jump (address is CBIOS when NZCOM) 

DEFE 

’ 2 3 ENV ' 

, Er vi ronment ID 

DEFE 

90H 

; Env type (>=9QH means E/P Extended ENV w/User 

DEFW 

EXPATH 

; External path (PATH) 

DEFE 

EXPATHS 


DEFW 

RCP 

; Resident command package (RCP) 

DEFE 

RCPS 


DEFW 

I OP 

; Input/output package (IOP) 

DEFE 

IOPS 


DEFW 

FCP 

: Flow command package (FCP) 

DEFE 

FC.PS 


DEFW 

Z3NDIR 

; Named directories (NDR1 

DEFE 

Z3NDIRS 


DEFW 

Z3CL 

; Command line (CL) 

DEFE 

Z3CLS 


DEFW 

Z3ENV 

; Environment (ENV) - Actual Starting Address 

DEFE 

Z3ENVS 
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DEFW 

SHSTK ; 

Shell stack (SH) 

DEFB 

SHSTKS 


DEFB 

SHSIZE 


DEFW 

Z3MSG ; 

Message buffer (MSG) 

DEFW 

EXTFCB ; 

External fcb (FCB) 

DEFW 

EXTSTK ; 

External stack (STK) 

DEFB 

0 ; 

Quiet flag (1=quiet, 0=not quiet) 

DEFW 

Z3WHL ; 

Wheel byte (WHL) 

DEFB 

9 ; 

Processor speed (MHZ) 

DEFB 

’P’-'iS’ ; 

Max disk letter 

DEFB 

31 ; 

Max user number 

DEFB 

i : 

1 = Ok to accept DU: , 0 = Not Ok 

DEFB 

O ; 

CRT selection () 

DEFE 

0 ; 

Printer selection () 

DEFB 

80 ; 

CRT 0: width 

DEFB 

24 ; 

tt of lines 

DEFB 

22 : 

tt of text lines 

; In Extended 

EM V , CRT 1 is replaced by System Infc 

; ; DEFE 

132 ; 

. CRT 1: Width 

. : DEFE 

24 : 

# of lines 

: : DEFB 

22 ; 

# of text lines 


P0NI-1LK J I HGFEDCBA 



IF RAMDSK 


DEFW 

0001000001 1 1 1 1 1 1 E 

. Ram is Drive 1! 


ELSE 


DEFW 

00000000011 11 1 1 1B 

. Valid drives vector 


ENDIF 


DEFB 

0 

( Reserved 1 

DEFE 

£0 ; 

PRT 0: width 

DE C E 

6 f 

tt of lines 

DE C E 

56 : 

tt of text lines 

DEFE 

1 ; 

FF flag (1=can Form Feed) 

;= = = = = = ==.= US 

urped Frtl storage for Resident User Space Vectors 

: , DEFE 

96 

PRT 1: width 

; ; DEFE 

66 ; 

tt of 1 i nes 

DEFE 

58 

ft of text lines 

; ; DEFE 

1 

FF flag (1=can Form Feed) 

DEFE 

USPCS ; 

Remaining Free User Space frees) 

USRSP : DEFW 

USPC ; 

Res. User Space base Address (xx00H/xx80H ) 

DEFB 

USPCS ; 

Size of Res. User Space in 128-byte recs 

; In Extended 

EtIV. Printers 2 and 

3 are gone, replaced by System Info 

: : DEFE 

13 2 

. PRT 2: Width 

; ; DEI E 

5f 

tt of lines 

; ; DEFE 

5E ; 

tt of text lines 


■to 


v-» *. I 
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DEFB 

1 


FF flag (1=can form feed) 

DEFB 

132 


. PRT 3: Width 

DEFB 

83 


# of lines 

DEFB 

82 


# of text lines 

DEFE 

1 


FF flag (1=can form feed) 

DEFW 

CPF, 


CCP base address 

DEFB 

[DOS-CPR] /I 28 


Size of CCP in 128 byte records 

DEFW 

DOS 


Bdos base address (xxOOH or xx80H) 

DEFB 

[BIOSJT-DOS] /I 

28 

Bdos buffer size in 128 byte records 

DEFW 

BIOS JT 


Eios base address (N2BI0 if NZCOM running) 

DEFB 

’SH 


Shell variable filename 

DEFB 

’VAR’ 


Shell variable filetype 

DEFB 

- 


File 1 

DEFB 

> 



DEFB 

> ■ 


File 2 

DEFB 

■ 



DE C E 



File 3 

DEFE 

’ 



DEFE 



File 4 

DEFB 




DEFE 

0 


Public drive area (ZRDOS +) 

DEFE 

0 


Public user area (2PD0S +) 


Env 128 bytes lone 


5.3.2 Terminal Capabilities. 

In acu.i t ion to the Basic Env i ..-onraent Descriptor described above . 
Terminal capability record structure (TCAP. also known as TERMCAP) is 
to reserve space for. and define default capabilities of the compute 
na 1 . The default TLRMCAP is fully compliant with the VLJB routines 
the 2-System Community after V1.1R4D. the skeleton record structure G 


•***»*» «»***■***»**. **?**>»* *>»■***»*•*.**** ».*'»■»*»**'»***»*******#**** **■*»■**■»**** 

; This TermCap Data for the New Z-System complies with VLIB4D specs and more 
fully describes tiie terminal and its capabilities. Edit the fields with 
, values for your terminal characteristics, or use it as a template for an 
; outboard definition loaded from the Startup file. 

TCfi^: DE^E ’ ’ : Terminal Name (13 bytes, space terminated) 

BIS : DEFE G0ELD-ENV2 : Offset to GOELD in graphics section 

B14: DEFB 1000000QE ; Bit 7 = Extended TCAP. remainder undefined 


B 1 5 

bO 

Standout 

0 

: Half-Intensity, 

1 

- Reverse Video 

BIS 

bi 

Power Up Delay 

0 

= None , 

1 

= 10-second delay 

El 5 

b2 

No Wrap 

0 

= Line Wrap, 

1 

- No Wrap if char written 
to last character in line 

B 1 5 

b3 

No Scroll 

0 

r Scroll . 

1 

- No Scroll if char written to 
last char in last line of dip! ay 

El 5 

b4 

ANSI 

0 

r ASCII , 

1 

- ANSI 


a dummy 
at cache:: 
r te mo- 
used ir. 
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DEFe 

OOOOOOOOB 

; 

Reverse Vid, Wrap, Scroll , ASCII 




Additional single character cursor motion bytes 

DEFE 

■E'-'w- 


Cursor Up 


DEFE 

’ X ’ - ’ ™ ’ 


Cursor Down 


DEFE 

’ D ' - ’ 


Cursor Right 


DEFB 

''gj 

i 

to 


Cursor Left 


DEFE 

0 


CL Delay for Screen Clear 


DEFB 

0 


CM Delay for Cursor Motion 


DEFB 

0 


CE Delay for Clear to End-of-Line 



; 

Stri ngs 

start here 


DEFB 

o 


(CL) Home Cursor and Clear Screen 


DEFB 

0 


(CM) Cursor Motion 


DEFB 

0 


(CE) Clear to End-of-Line 


DEFB 

0 


(SO) Reverse On 


DEFB 

0 


(SE) Reverse Off 


DEFB 

0 


(TO) Terminal Init 


DEFE 

0 


(TE) Terminal De-init 




Extensions tc Standard Z3TCAF 


DEFE 

0 


(LD) Delete Line 


DEFE 

c 

; 

(LI) Insert Line 


DEFE 

0 


(CD) Clear from Cursor to End-of-Scr 


; 

Att ri but 

es setting parameters 


DEFE 

0 


Se 1 Attributes 


DEFE 

0 

, 

Attributes String 




Read items from screen 


DEFB 

0 


Report Cursor Pos'n (ESC Y Pn Pn) 


DEFB 

0 


Read Line Under Cursor 


DEFE 

0 

; 

On/Off Delay 



; 

Graphics 

strings offset from Delay value. 


DEFE 

0 


Graphics On 


DEFE 

0 

; 

Graphics Off 


DEFE 

Q 


Cursor Off 


DEFE 

0 

; 

Curscr On 




Graphi cs 

Characters 


DEFE 



Upper-Left corner 

t* 3 

DEFE 



Upper-right corner 

[*) 

DEFB 

’ » ’ 


Lowei — Left corner 

[*] 

DEFE 



Lower-right corner 

t* 3 

DEFB 



Horizontal Line 

[-3 

DEFB 

' \ ' 


Vertical Line 

c : 3 

DEFE 

’ » ’ 


Full Block (hashed block) 

[*3 

DEFB 

■# ’ 


Hashed Block (big X) 

[#] 

DEFB 

’+ ’ 


Upper Intersect (Upside down "T") 

[+3 

DEFB 

’ + ’ 


Lower Intersect ("T") 

[ + 3 

DEFE 

’+ ■ 


Mid Intersect (Crossing Lines) 

[ + 3 

DEFE 



Right Intersect ("T" rotated left) 

[ + 3 

DEFE 

’ + ’ 


Left Intersect ("T" rotated right) 

[ + 3 

DEFE 

0 




DEFE 

0 





PROGRAMMING 


61 



B/P BIOS UTILITIES 


GENERAL 


6. 8/P Bios Utilities. 

We have developed and adapted many support routines to assist you in using and 
tailoring B/P Bios installations. Many of these follow generally established 
functions, and their use may be readily perceived. Others are adaptations of 
routines which we developed to support our earlier ZSDOS operating system, or 
are adapted from routines available in the Public Domain. The remainder were 
written specifically to support this product. 

Each support routine follows generally-acknowledged practices of Z-Syster: 
Utilities, including built-in Help, and re-execution with the GO command . 
Help is accessed by typing the name of the desired routine followed by a 
double-slash (i.e. LDSYS //). Additional information is provided in the 
following sections oi this manual. 

Some of the features of B/P bios are supported with Version-dependent pro- 
grams. These vary among specific systems and should not be intermingled if 
you support a number oi dif terent computer types . Contact us if you nc-ed to 
C'eate such a specific tailored version of one of these programs. In the 
following ciescr ipi ions, the routines which are restricted to a specific system 
or which require Tailoring are so annotated . 
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6.1 BPBUILD - System Image Building Utility. 

The purpose of BPBUILD is to create a loadable System Image. Input tiles 
needed by this utility include the output of assembling the BPBlO-xx file (in 
Microsoft REL format), a REL or ZR1. image of an Operating System (ZSDOS for 
unbanked or ZSDOS2.ZRL for fully banked systems are recommended), and a RLL or 
ZRL image of a Command Processor (ZCPR33.RLL for unbanked, Z40.ZRL for fully 
banked systems are recommended). 

BPBUILD is capable of incorporating many types of operating sj-stem components 
into the executable image. Among systems tested are customized BIOSes, ZRDOS, 
CP/M 2.2, ZCPR2, ZCPR3x and others. One restriction in any segment occurs in 
the use of Named COMMONS for locating various portions of the system within 
the processor's memory map. Most assemblers and linkers are limited in the 
number of different named COMMON bases which can be supported. The linker 
incorporated in BPBUILD can handle only the following named COMMONS: ENV , 

MCL. . MSG. , FCB , _.SSTK , XSTK , BIOS , BANKS , B2RAM , and RESVD . 

6.1.1 Using BPBUILD. 

BPBUILD operates with lave red Menus and may be invoked to build a replacement 
for an existing Image file, or with defaults to construct a totally new Image 
file. All riles needed to construct the desired image: Bios. Dos. and OPR 
must reside in the current Drive and User Area, or be accessible via the 
PUBlic attribute it operating under ZSDOS. The syntax for BPBUILD is: 

BPBUILD - Generate system w/defaults 

BPBUILD fn[.ft] - Make /Modify a specific system 

(Default type is .IMG; 

BPBUILD // - Display this Message 

It should be noted that if ZSDOS2 is the selected Dos. Bit Allocation buffers 
for Hard Drives are located in the bystem Bank. 

6.1.2 Menu Screen Details. 

Upon starting BPhldl D. you will be presented with the main menu screen. If or 
this screen, you may se Bet oni of the three main categories to tai lor the 
output image. At any point in the configuration, pressing Controi-C or Ts; ape 
will exit the menu and return to the Command Processor prompt . 


Main 




1 

File Names 


2 

BIOS Configuration 


3 

Envi ronment 



Selection : 
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6.1. 2.1 Screen 1 - File Names. 

Selecting option One from the main menu will present a screen listing the 
current file names for the three input files needed to build an image, and the 
name to be applied to the output file. If BPBUILD was executed with the name 
of an existing Image file, the file names will be those of the files used to 
build the specified Image file, otherwise it will be default names furnished 
by BPBUILD. A sample screen for a non-banked YASBEC system might be: 


Files (1 

1) 



1 

Command Processor File 

ZCPR33 

.REL 

2 

Operating System File 

ZSDOS 

. ZRL 

3 

B/P Bios Source File 

B/P-YS 

-REL 

4 

B/P Executable Image 
Selection ; 

BPSYS 

.IMG 


Selecting any one- of the four options will allow you to change the name of the 
file to use for the desired segment. Default File types exist for each entry 
with both the Command Processor ant: Operating .system files defaulting to . ZRI 
4 no type is entered. The Bios file defaults to .EEL . while the Image output 
f i 1 e de i au Its. t o . I M. . . 

6.1. 2. 2 Screen 2 - BiOS Configuration. 

Selecting BIOS Configuration from the Main Menu (Selection 2 } presents the 
basic screen from which the sizes and locations of either existing system 
segments (if building from an existing IMG file) or default values front within 
BPBITIJ). A sample screen might appear as: 


r“ "■ 

Environment (2.1 

) 



COMMON (Bank 0) 

MEMORY 


BANK 2 MEMORY 

A Common BIOS 

- D400H 

E 

Banked BIOS - OOOOH 

Si ze 

83 


Size - 0 

B Common BOOS 

- C600H 

F 

Banked BDOS - OOOOH 

Si ze 

28 


Size - 0 

C Command Proc 

- BE00H 

G 

Command Proc - OOOOH 

Si ze 

16 


Size - 0 

D User Space 

- E900H 

H 

User Space - OOOOH 

Si ze 

6 


Size - 0 

Selection : 
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While the ability to dictate locations and sizes Lor various system sizes is 
provided at this point, we urge you not to alter the values for Bank 2 Memory 
unless you are VERY familiar with the potential effects and willing to risk 
potentially disastrous consequences. The primary reason for including this 
screen was to allow setting Common Memory base locations and to dictate the 
size of the Resident User Space. Other than specifying the Common User Space 
size (the starting location defaults to the address in Z3BASE.LIB), the re- 
maining values were included primarily for the few specialized users who 
require custom system locations. 

6.1. 2.3 Screen 3 - Environment Configuration. 

Since the Environment Descriptor is an integral part of the Operating System 
due to the specification of low-level parameters such as memory allocations, 
this screen is provided to configure the memory map in a suitable fashion for 
the system being built. For example, in a Fully Banked system with ZSDOS2. 
there is normally no need for a Resident Command Processor. Using this screen 
then, selection D may be used to indicate that no space is used for the RCP by 
setting its location and size to zero. With this space freed, the JO Package 
(Selection C! may be raised to F400H. keeping its size at 12 records. Since 
these are the two lowest segments in the memory map. BPBUILD will, use this as 
the lowest value used in the Environment, and move the Operating System seg- 
ments (including the Resident User Space) up in memory for an increase of 2k 
bytes in Transient Program Area. 

It is important to note that the Fnvironment Descriptor defined in this screen 
is stored in a special area within the . IMG file produced and placed in memory 
by I.DSYS when activated. Any alteration after loading, for example loading 
another ENV file as part of the STARTUP script may cause the system to operate 
incorrect 1 y . 


Envi ronment (3.1) 





A 

- Environment 

FEOOH 

F 

- Named Dirs 

FC00H 


Size (# recs)- 

2 


# of Entries - 

14 

B 

- Flow Ctrl Pkg - 

FAOOH 

G 

- External Path - 

FDF4H 


Size (# recs)- 

4 


# of Entries - 

5 

C 

- I/O Package 

ECOOH 

H 

- Shell Stack 

FD00H 


Size (# recs)- 

12 


# of Entries - 

4 

D 

- Res Cmd Proc - 

F200H 


Entry Size 

32 


Size (# recs)- 

16 

I 

- Msg Buffer 

FD80H 

E 

- Command Line - 

FFOOH 

J 

- Ext. FCB 

FDDOH 


Size (bytes) - 

208 

K 

- Ext. Stack 

FFDOH 


Selection : 





When all configuration or inspection activity is complete at any menu, enter- 
ing a return with no selection will return to the previous menu screen (Main 
menu from lower screens), and will start the build activity ii a single return 
is entered from the main menu. All specified files are first read to deter- 
mine their sizes, and internal memory address calculations are performed. You 
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will be asked if you desire BPBUILD to use optimal addresses for the maximum 
amount of Transient Program Area (AutoSize), or use the values which were 
specified in menu 2.1. If you enter N at this point, the build will progress 
under the assumption that you want to use the values from Menu 2.1. A second 
prompt will ask you if you want to build a system of "standard' 1 segment sizes. 
This refers to the CP/M 2.2 standard sizes of 16 records (2k) for the Command 
Processor and 28 records (3.5k) for the Basic Disk Operating System (BDOS). 
If you answer Yes, AND the segments are equal to or less than these sizes, the 
system will be built to reflect these system segment sizes. Since many ill- 
behaved. but very popular, programs assume the old CP/M segment sizes, this 
option should generally be used. If the autosize query is selected. BPBUILD 
automatically executes to completion and returns to the Command Processor 
prompt . 

To ohtain the maximum Transient Program Area with "standard" segment sizes, 
the easiest method is to execute BPBUILD exiting with the Autosize query 
answered in the affirmative (Yes), then execute BPBUILD again on the produced 
image answering the first query with N for No Autosizing, and the second query 
with a Y to adjust the lower segment sizes for "standard” segment locations. 
While this is a somewhat cumbersome procedure, it results in a much smaller 
and faster running utility than otherwise possible, and was a design tradeoff 
in the development process. 
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6.2 BPCNFG - Configuration Utility 

The flexibility of the B/P Bios architecture permits customizing to vour 
system and desired methods of operation. This utility consolidates some of 
the more common and important tailoring features in a single utility. BPCNFG. 
the B/P Bios Configuration Utility, provides an easy, menu-driven means of 
tailoring Hard and Floppy Drive Boot Sector images. Relocatable Image (IMG) 
files, and certain elements in an executing system. Using BPCNFG reduces the 
need to assemble a new Bios image for simple changes, and increases the speed 
with which changes can be made. 


6.2.1 Using BPCNFG. 

BPCNFG syntax follows the standard conventions summarized in Section 1.2. and 
responds to the standard help option sequence of two slash characters. The 
syntax under which BPCNFG is invoked is dictated by the type of system you 
wish to configure. The BPCNFG Syntax is: 


BPCNFG // 

< 

Print Built-in Help Summary 

BPCNFG 

< 

Run interactive, screen mode 

BPCNFG * 

< 

Configure Executing System 

BPCNFG d C : ] 

< 

Configure Drive "d" 

BPCNFG [du:]filename[.typ] 

< 

Con figure I mage I i i e 


The First form of the syntax is sei f-expianaton and simply prints a short 
help file listing the purpose of the utility and the syntax ol the program 
use. The Interactive mode ol operation, execution of BPCNFG with no argu- 
ments. will first ask uu whether you v, ish to configure a Memory. Disk or 
Image version of a B/P Biot system, and set internal parameters to that mode . 
as well as loading live requisite data if needed. If no file type is specified 


for an I ma; 

cc 1 i i e . a \ yp 

e of . IM ' 

is assumed. 




RPGNFG may 

configtne op 

t i ons i n 

the currently 

ope rat i ng 

sys ten: 

with some 

1 i mi tat ions 

The most s 

i gn i f i c an t 

! i n. i t a t i on i s 

that Hard 

Drive 

part i t ions 

may not De- 

altered since 

space for 

the required bit buffers 

(A1..V and CSV ) is 

allocated a 

t system ioad 

( boot ) t 

ime and cannot 

be reset 

when a 

system is 


already installed. With this exception, all other parameters may be varied 
and will be in effect until another system is loaded by Cold Booting the 
computer, or loading an Image file with LDSYS. 

To abort the BPCNFG without changing current parameters, press either ESCape 
or Control-C from the main menu display. Option setting will occur il a 
Carriage Return only is entered from the Main Menu Screen. 


6.2.2 Menu Screen Details. 

BPCNFG is a Screen-oriented support routine using the terminal attributes 
defined in the currently-installed Termcap. Five main screens are current iy 
defined at the main menu, with several selections resulting in sub-mem. 
screens. The first is the main menu from which the general category is se- 
lected for alteration. The tor screen line reflects the level and mode as: 
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Mai n 

Menu - Configuring Image File [A10:T1.IMG 
Bios Version 2.0 

] 

1 

System Options 


2 

Character 10 Options 


3 

Floppy Subsystem Options 


4 

Hard Disk Subsystem Options 


5 

Logical Drive Layouts 
Enter Selection : 



Each of the five selections results in a sub-menu screen which depicts the 
specific elements which may be changed and the current values/sett ings . Each 
of the selection screens is detailed below. 


6.2.2. 1 Screen 1 - System Option Parameters. 

The System Options may be set from Menu Screen 1 which may appeal' as: 


Menu 

1 - System Options 


1 

System Drive = 

A; 

2 

Startup Command = 

"START01 " 

3 

Reload Constant = 

23040 ( 5A00H ) 

4 

Processor Speed = 

9 MHz 

5 

Memory Waits = 0, 

10 Waits = 0 


Enter Selection 



The Logical System drive selected by the first entry is used by the Bios Warm 
boot to load the operating system on a Cold boot, and on Error Exits. The 
Startup command is normally the name of a COM file which performs additional 
system initialization when first started. Such a file is normally created by 
entering a sequence of instructions (file names and arguments) into a script 
using ALIAS. SAL I AS. VAT. IAS or other similar ZCPR3 tool. 
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The remainder of the entries concern the Physical hardware within the computer 
and generally do not need to be changed for other than initial installation. 
The Reload Constant at Selection 3 may be "fine tuned" by slightly varying the 
value. The normal effect of this is to adjust the speed of the Real Time 
clock within the computer to allow it to keep proper time. The Processor 
Speed (Selection 4) should be the CPU Clock speed rounded to the nearest 
MegaHertz. For example, the rate shown in the sample screen is, in fact, 
9.216 MHz. When the Clock Speed is changed, an option is offered to automati- 
cally scale the Reload Constant (Selection 3) to scale it by a proper factor 
based on the amount that the Clock Frequency was changed. This is not always 
needed, but is generally desirable in HD64 1S0/Z- 180 systems using an interrupt 
clock tinier. 

The number of Memory and 10 Waits at Selection 5 are in addition to any Wait 
states inserted automatically in the hardware. For example, the Zilog Z1S0 
inserts one wait state into all 10 Port addresses. Since BPCNFG is a general 
purpose utility, it cannot know this. The number set with this selection is 
therefore in addition to any hardware injected wait states. 

A sixth menu also exists, but since inadvertent alteration of its values can 
result in bizarre and potentially destructive consequences, its existence is 
hidden and prompted if selected. The interaction to select option 6 is: 

Enter Selection : 6 

— This is DANGEROUS. . .Proceed? (Y/[Nj) : 

If an explicit Y is entered, the hidden menu is displayed appearing as lol lows 
for a YASBEO with the MEM4 address in <■• PAL. which allows the lull 1 Megabyte 
range to be used: 


Menu 

1.1 - System Bank 

Numbers 

1 

TPA Bank # 

= 1 

2 

System Bank # 

= 3 

3 

User Bank # 

= 4 

4 

RAM Drive Bank # 

= 5 

5 

Maximum Bank # 

= 31 


Enter Selection 



The bank numbers should reflect the Physical 32k bank numbers in the system 
progressing from the lowest, or first available, to the highest. The Bank 
numbers are Zero-based, and may range from 0 to 255 (OFFH). The User Bank and 
RAM Drive Banks may he set to Zero if No Banked User area or RAM Drive respec- 
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tively is desired. It should be noted that the actual control for these two 
features is in other screens, and setting the Bank Numbers to Zero while the 
options are active can have adverse consequences. 

6.2. 2.2 Screen 2 - Character 10 Parameters. 

Screen Menu 2 allows configuration of the Character 10 subsystem, to include 
assignment of logical devices to physical devices. A sample screen for the 
YASBEC might appear as: 


Menu 

2 - Character 10 Options 





1 

IOBYTE Assignment: 






Console = COM2 
Auxiliary = C0M1 
Printer = PI0 





2 

C0M1 - 9600 bps, 6 Data, 1 

Stop, 

No 

Parity, 

[In(8)/Out(8)] 

3 

COM2 - 19.2 kbps, 8 Data, 

1 Stop, 

No 

Parity, 

[In(7)/0ut ( 8 ) ] 

4 

PI01 - [Out (7) ] 





5 

NULL - [In(8 ) /Out (8 ) ] 





6 

COM3 - 38.4 kbps, 8 Data, 

1 Stop, 

No 

Parity, 

[In(6)/Out(8) ] 

7 

Swap Devices 






Enter Selection : 






Selection 1 determines which of the active devices is assigned to the address- 
able functions dictated by the IOBYTE. This location in memory is used by the 
operating system for Character TO normally consisting of the Console. Printer 
(List Device in CP/M terminology ) and an Auxiliary 10 (Reader and Punch in 
CP/M). The exact Devices assigned to these Logical functions depends on the 
bit-mapped characteristics of the IOBYTE, and positioning within the table 
portrayed in this Menu. 

Early versions of B/P Bios (Versions 1.0 and earlier) distributed as "Starter 
Systems and test versions used a fixed number of devices and a different data 
structure lor device access. B/P Bios Production systems with Version numbers 
of 1.1 through 1.9 will contain only four device drivers, but use the newer 
data structures. Beginning with Version 2.0, however, many Character Devices 
may be accommodated, with the first four being directly accessible by the 
IOBYTE. and the ability to exchange devices to place any four in the first 
positions for access by applications programs. The above screen depicts a 
typical display under a Version 2.0 Bios. Smaller systems such as placed on 
the Boot Tracks will use only four fixed devices with a typical Version Number 
of 1.1 and will not include selections 6 or 
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Selection 1 offers the opportunity to select which of the first four physical 
devices is assigned to the three logical IOBYTE defined functions. A second- 
ary menu will prompt you for the exact functions and devices. .An example of 
the interaction with selection 1 is: 

Set [Cjonsole, [Auxiliary, or [P]rinter : C 
Set Com[1], Com[2], [P]io, or [N]ull ? 

Selections 2, 3 and 6 in this sample screen allow configuration of the serial 
ports included in this B/P Bios. If you are making hardware changes in the 
Bios, please follow the specifications in the source code to insure that this 
utility will function as described. For most system installations covered to 
date, one or more of these options will have no effect, but the capability 
still exists to configure the option. This selection results in a series of 
options being presented for verification or alteration. Current settings are 
listed as default values which will remain selected if no entry is made before 
the ending Carriage Return (Enter key). A Sample interaction on a YASBEC is: 

Configuring C0M1 [In(8)/0ut(8)] : 

Baud Rate (Max=38.4 kbps) = Selections are: 

1-134.5 bps 2-50 bps 3-75 bps 4-150 bps 

5-300 bps 6-600 bps 7-1200 bps 8-2400 bps 

9-4800 bps 10-9600 bps 11-19.2 kbps 12-38.4 kbps 

Select [10] : 

Data = 8-bits. Change? (Y/[N]) : 

Stop Bits = 1-bits. Change? (Y/[N]) : 

Parity = None Change? (Y/[N]) : 

XON/XCrF Flow = No Change? (Y/[N]) : * Defaults selected 

RTS/CTS Flow = No Change? (Y/[N]) : 

Input is 8-bits. Change? (Y/[N]) : 

Output is 8-bits. Change? (Y/[N]) : 

Selection four tailors the default parallel port, normally a Centronics print- 
er interface. As with previous selections, not all options may be active, but 
will appear in the configuration sequence to retain the generality of BPCNT'G. 
Current settings (in braces) will be retained if a Carriage Return is entered. 

Configuring PI01 [Out ( 7 ) ] : 

XON/XOFF Flow = No Change? (Y/[N]) : 

RTS/CTS Flow = No Change? (Y/[N]> : 

Output is 7-bits. Change? (Y/[N]) : 

The final selection (only appearing in Bios Versions 2.0 and later) allows the 
exchange of devices. In the sample Menu 2. Selections 2-5 are active devices, 
with Selection 6 existing in the Bios, but not accessible. Using the last 
selection. COM3 could be exchanged with one of the first four making it an 
active device upon exiting BPCNFG which calls the Device Configuration func- 
tion. The interaction may appear as: 

Exchange Device : 3 With Device : 6 

After this choice, active devices will be C0M1. COM3. PI01 and NULL. 
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6 . 2 . 2. 3 Screen 3 - Floppy Disk Parameters. 

Extensive tailoring of the Floppy Disk subsystem is possible at this Screen. 
While many popular systems do not support all options (mainly due to the 
Controller logic), all options and respective settings will appear to be set 
at this point. Also, while such items as the Step rate will accept increments 
of a set size (1 mS for Step Rate), many systems have discrete increments that 
do not match allowable values. For example, the SMS 9266 used in MicroMinds 
SB-180 will only accept 2 mS increments with 5 1/4" Floppy Drives, the WD 1770 
used in the Ampro Little Board only steps at 6. 12, 20 and 30 mS. while the 
1772 used in the YASBFC permits 2, 3, 5, and 6 mS Steps. The rates set with 
BPCNFG are suitably rounded up to the most appropriate rate within the Bios 
code during drive selection to allow tailoring of drives in a generalized 
manner. Options tailorable for Floppy Disk drives as seen on a YASBFC are: 


Menu 3 - Floppy Disk Options 


1 


Floppy Drive Characteristics: 
DrvO = 3.5" DS, 80 Trks/Side 

Step Rate = 3 mS, Head 
Drvl = 5.25" DS, 40 Trks/Side 
Step Rate = 4 mS, Head 
Drv2 = 5.25" OS, 80 Trks/Side 
Step Rate ; 3 i»S, Head 
Drv3 = 5.25" DS, 80 Trks/Side 
Step Rate = 6 mS, Head 


toad = 

4 l 

mS, 

Unload = 240 mS 

Load = 

24 

mS , 

, Unload = 240 

mS 

Load = 

24 

mS, 

, Unload = 240 

mS 

Load = 

24 

mS, 

, Unload = 240 

mS 


2 Motor ON Time (TenthS-of-Seconds) : 100 

3 Motor Spinup (Tenths-of-Seconds) : 5 


4 Times to Try Disk Operations : 4 


Enter Selection 


Selecting one ol the four items on this menu will prompt j r ou for the informa- 
tion needed, allowing you to retain current settings as a default. An example 
of the additional prompts resulting from selection one on the above screen is: 


cp 

Configure which unit [0..3] : 2 

Size 8" ( 1 ) , 5.25"(2), 3.5"(3)? [2] 

Single or Double-Sided Drive ? (S/[D]) 

Motor On/Off Control Needed ? ([Y]/N) 

Motor Speed Standard or Hi-Density (CS]/H) 

Tracks-per-Side (35,40,80) [80] 

Step Rate in Mi 1 1 i-Seconds [3] 

Head Load Time in Mi 11 i-Seconds [24] 

Head Unload Time in Mi 1 1 i-Seconds [240] 
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e.2.2.4 Screen 4 - Hard Disk Parameters. 

The R/P Bios Hard Disk Subsystem is centered around the Small Computer Systems 
Interface (SCSI) standard. Backward compatibility with the earlier Shugart 
Associates System Interface (SASI) is also provided to allow older controllers 
to be used. During the course of B/P Bios development, several controller 
types were incorporated, with unique features accommodated in a transparent 
way within the utilities. As a compromise between flexibility and program 
size, a limit of three physical hard drive units was placed on the system. 
This limit does not impact the 16 possible logical drives which the computer 
may handle. A sample Menu for a single Conner CP-3100 SCSI Drive of 100 
Megabytes is: 


Menu 4 - Hard Disk Options 

1 Hard Drive Controller = Seagate SCSI 

2 First Drive Physical Unit 0, Logical Unit 0 

No. of Cylinders = 776, No. of Heads = 8 

3 Second Drive : - inactive - 

4 Third Drive : - inactive - 

Enter Selection : 


The first available selection allows you to select the type of controller 
installed or used in the system. The controller definition applies across all 
three physical drives, so some care must be applied in mixing different con- 
troller types on the same system. For example, a Shugart 1610-3 controller is 
incompatible with a Seagate SCSI or SCSI-2 drive attached directly to the SASI 
bus since initialization information is required of drives on the 1610-3 which 
must not be sent to the SCSI due to the differing commands. The controller 
types defined in the initial release of B/P Bios appear in Selection 1 as: 

Select Controller Type as: 

(1 ) Owl 

(2) Adaptec ACB-4000a 

(3) Xebec 1410a/Shugart 1610-3 

(4) Seagate SCSI 

(5) Shugart 1610-4/Minimal SCSI 

(6) SCSI-2 

Enter Selection : 

Selections two. three and four from Menu 4 allow you to specify the physical 
parameters of one of the three possible drives. As with other options, some 
of the parameters do not apply, such as Reduced Write and Precompensation with 
SCSI drives, but appear here to allow a general configuration tool. Current 
settings appear in square braces and are selected if only a Carriage Return is 
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entered. A sample entry configuring the Conner CP-3100 is: 


Activate Drive ( [Y]/N) ? 

Physical Unit (0..7) [0] 

Logical Unit Number (0..7) [0] 

Number of Physical Cylinders [776] 

Number of Heads [8] 

Reduced Write Starting Cylinder [0] 

Write Precomp. Start Cylinder [0] 


6.2.2. 5 Screen 5 - Partition Parameters. 

Menu 5 permits arranging the physical drive complement into Logical Drives, 
and dividing physical units into multiple logical Partitions. 


Menu 5 - Logical Drive Layout 

A 

= Unit 0, 64 Sctrs/Trk, 4k/Blk, 79B4k (998 Trks), 1024 Di rs 

B 

= Unit 0, 64 Sctrs/Trk, 4k/Blk, 20000k (2500 Trks), 1024 Di rs 

C 

= Unit 0, 64 Sctrs/Trk, 4k/Blk, 20000k (2500 Trks), 1024 Di rs 

D 

= Unit 0, 64 Sctrs/Trk, 4k/Blk, 54432k (6804 Trks), 2048 Di rs 

E 

= Floppy 0 

F 

= Floppy 1 

G 

= Floppy 2 

H 

= -- No Drive -- 

I 

= — No Drive — 

J 

= -- No Drive -- 

K 

- — No Drive — 

L 

= -- No Drive -- 

M 

= RAM 

N 

= -- No Drive -- 

0 

= -- No Drive -- 

P 

= -- No Drive -- 


1 Swap Drives, 2 Configure Partition 3 Show Drive Allocations 


Enter Selection : 


Selection 1 allows for swapping two specified logical drives. For example, 
the above screen shows a system which will boot from a hard drive. If the 
system were being configured for a Floppy-based system you might swap drive A 
with drive E with Selection 1 as: 

Enter Selection : 1 

Swap drive [A..P] : A with drive [A..P] : E 

Selection 2 permits defining logical partitions on a Hard drive, and of the 
RAM drive, if active. It queries you for the needed information from which to 
set internal Bios values. If convert ing from an existing system, SHOWHD (See 
6.19) will display the values to enter for a specified Partition. An example 
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of the interaction is: 

Configure which Drive [A..P] : D 

Allocation Size (1, 2, 4, 8, 16, 32k) [4] : 

Number of Dir Entries [2048] : 

Starting Track Number [6000] 

# Tracks in Partition [6804] : 

Physical Unit Number [0] 

Selection 3 from Menu 5 may be used in conjunction with the allocation to view 
the existing allocations for a given Hard Drive Unit. Selecting 3 prompts you 
for the Desired Hard drive as: 

Display Allocations for which Hard Drive [0..2] : 

and will show the current Partitions and allocations. As an example, the four 
partitions on the Conner CP-3100 depicted in the Menu 5 screen are reported 
here on a separate screen as: 


Partition Data Hard Drive Unit 

: 0 

Drv 

Start Trk 

End Trk 

A 

2 

999 

B 

1000 

3499 

C 

3500 

5999 

D 

6000 

12803 

[any 

key to continue] 
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6.3 BPDBUG - B/P Bios Debug Utility 

This utility provides a low-level tool patterned after Digital Research's DDT. 
but extended to provide a more useful user interface, the ability to handle 
ZSO and Z180 mnemonics in disassembly, and memory banking using B/P Bios 
interfaces. While the description is primarily oriented to screen output, the 
Operating system permits also sending output to the defined Printer by tog- 
gling Control-P which may be enabled and disabled within BPDBUG. 

6.3.1 Using BPDBUG. 

The syntax for BPDBUG is simple with only three variants as: 


BPDBUG // 

< — Print a 

short help message 

BPDBUG 

< — Execute 

BPDBUG 

BPDBUG [fn[.ft]] 

< — Execute 

BPDBUG, Loading named file 


When executed. BPDBUG relocates the majority of the code to high memory imme- 
diately below- the BDQS, overwriting the Command Processor. If a file load is 
specified as in the third method of invocation shown above, and the file type 
is .HEX, then a file in Intel HT.X format is assumed and it is converted to 
binary form at the specified address. 

In addition to the short help message available with the double-slash option, 
a built-in command summary is available at all times from the main BPDBUG 
prompt by entering a Question Mark. The summary appears as: 


E/P Bios DBug V 0.3 


Available commands: 

B{ank} Bank# 

D{ump} [From [To]] 

E{nter> Addr 

F{ill] Start End Byte 

G{o] Addr 

H{ex sum/di ff] Wordl Word2 
I{nput] Port# 

L{ i st } [From [Thru]] 

M{ove] Start End Dest 
N { ante } FN [ . FT] {for Read/Write} 
0{utput} Port# Byte 
R{ead file] [Offset] 

T{race} {Trace mode On] 

U{ntrace] {Trace mode Off) 

W{rite file] Number_of_256-byte_bl ocks 
X {set breakpoint} Addr 
Z{ero breakpoints] 

? {Show this msg] 
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Square braces in the .summary indicate optional parameters, while text strings 
and abbreviated names indicate parameters and types. 

6.3.2 BPDBUG Commands. 

6.3.2. 1 Select Memory Bank. [ B ] 

To select a memory bank in the range of 0..255, simply enter the Command "B" 
followed by the bank number in Hexadecimal. Optional spaces may be placed 
between the command letter and the Bank number. The syntax for this command 
is : 

B[ ]nn 

The Bank number selected by this command will be made the current bank for 
Display (D). Enter (E) and List (L) commands. If the specified bank number 
exceeds the largest bank number physically existing in the system, the bank 
number will be set to the last bank defined in the B/P Bios Header. 

6.3.2. 2 Dump (Display) Memory in Hex and Ascii. [ D ] 

This command displays memory contents in both hexadecimal and ascii form. 
Where the current byte in the display is a control character (less than 20H). 
a period character is printed in the ascii column. 

Defaults for this command are 100H and the TP A bank as the starting address, 
and 256 as the number of bytes to display if no End Address is specified. Tor 
subsequent uses of the Dump command, the Starting address will be one more 
than the ending address of the last Dump. The Bank Number will remain that 
last specified, or the TPA bank if never changed in a session. The syntax is: 

D[ ] [Start __Addr] [End_Addr] 

A sample of the output appearing on the screen is: 

-dlOO 1 2f 

01:0100 ED73 FE03 31 FE 0321 5D00 7E23 FE2F 2006 . S .. 1 / . 

01:0110 BE1 1 AD01 2625 2A01 002E 5A7E FEC3 2016 (**... Z'.. . 

01:0120 CDAC 0121 FAFF 197E FE42 200C 237E FE2F ...!... ~.B 


6.3.2. 3 Enter Values in Memory. [ E ] 

This command permits entering values into memory. A period terminates entry. 

E[ ] [Start_Addr] 

-el 00 
: 41 43 44 
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6. 3. 2. 4 Fill Memory with Constant Value. [ F ] 

Entire memory areas may be set to a single constant value with this command. 
All three arguments (Start. End and Value) must be specified, and the command 
will not be executed if fewer arguments are given. The syntax is: 


F[ ]Start End Value 

As an example, the following command sets the sixteen bytes from 100H through 
10FH in the currently selected bank to binary Zero: 

-flOO lOf 0 


6. 3.2. 5 Go (Execute) Program in Memory. ( G ] 

Execution may be started at any arbitrary address with the "Go" command. If 
no target address is specified. 100H is assumed since it is the normal start- 
ing address of programs loaded into the Transient Program Area. The syntax of 
the command is: 


G[ ] [Address] 


6. 3. 2. 6 Hex Sum and Difference. [ H ] 

Simple Hexadecimal addition and subtract ion is performed with the "Hex" com- 
mand . vox.; the command is executed with two addresses, both their sum (modulo 
6e536) and difference (also modulo 65536) are displayed in that order. The 
syntax of this command is: 

H[ ]Value1 Value2 

For example, if an offset of 45H from a base of 0ED3FH was desired, the re- 
sulting g positive and negative address couid be determined as: 

-hedSf 45 <— Entered 

ED84 ECFA < — ..returned Sum and Difference 

6.3.2. 7 Display Value from Input Port. [ I ] 

This command will read the desired Input Port in the range of 0 to OFFFFH and 
display the resulting byte. Since 16-bit address calculations are used, this 
command will properly read the built-in ports of the HD64180 and Z180. The 
syntax of the Input command is: 

I[ ]Port_num 
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6.3.2.8 List (Disassemble) Memory Contents. [ L ] 

Disassembly of executable instructions in memory is accomplished with this 
command. As with the ’'Dump" command, the starting address defaults to 100H 
when first loaded, and is assumed to be the instruction following the last one 
disassembled for subsequent uses of this command if no address is explicitly 
entered. If no Ending address is specified, 23-26 bytes will be contained in 
the listing depending on the length of the last instruction. The syntax is: 

L[ ] [Start] [End] 

A sample of an entry and the resulting output with an arbitrary program is: 


-1120 

127 



< — Entered 

0120 

CDAC01 

CALL 

01 AC 

< — ..displayed 

0123 

21 FAFF 

LD 

HL.FFFA 


0126 

19 

ADD 

HL,DE 


0127 

7E 

LD 

A, (HL) 



Note that the actual bytes included in the disassembled instructions are also 
listed in contrast to other similar programs to provide additional information 
for you. Additionally, an extra blank line is displayed after all uncondi- 
tional jumps and returns to serve as a visual representation as an absolute 
change in control flow. The mnemonics are standard Zilog Z1S0 codes. 


6.3.2. 9 Move Memory Contents. [ M ] 

This command permits blocks of data to be moved within memory. Memory address 
bounds checking is performed to insure that overlapping addresses are handled 
correctly so that minor shifts in blocks of data may be accomplished. The 
syntax for this command is: 

M[ ]Start End Destination 


6.3.2.10 Set File Name for Read/Write. [ N ] 

This command is used to set the file name and optional type prior to a read or 
write operation. The name remains active until changed or BPDBUG is exited. 
The syntax is: 


N[ ]Fi leName[ .Fi leTyp] 

6.3.2.11 Send Value to Output Port. L 0 ] 

This command forms the complement of the Input command covered above, 
sends a specified byte to the addressed Output port. The syntax is: 

0[ ]Port_num Value 
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As with all arguments, if more digits than the number needed are specified. 
onl_v the last two (for a Byte) or four (for an address) are used in the ex- 
pression . 

6.3.2.12 Read a File into Memory. [ R ] 

This command reads the file specified by the Name command into memory at the 
default address of 100H (if no offset is specified), or at a starting addres*; 
of Offset+iOOH. The Offset value must be specified in Hexadecimal. The 
syntax of the Read Command is: 

R[ ] [Offset] 

When the file is loaded, you will be informed of the current setting of the 
default address for the base of current memory (PC value) and the byte after 
the last one loaded by the Read Command (Next). The display might appear as: 

Next PC 
0880 0100 


6.3.2.13 Activate Trace Mode. [ T ] 

To assist in debugging programs . a Trace function is included which is acti- 
vated with this command . Upon encountering a breakpoint (See X Command be 1 ov. ) 
the program enters the Trace mode in which each instruction is trapped and. the 
state of the process: ' di--p yed along with a Disassembled listing of the 
instruction. Entering a single letter "1" activates the Trace Mode . 

A f ragmen t of a prog ran run with Trace On r- : 


S0Z0HCP0N1 CO A- 00 EC-0000 DE=0000 HL=000Q SP=Q100 


IX=A4AF. 

IY=FFFE 

0100 

C30B01 

JP 

010E 

SOZOMOPONi CO 

A=00 BC=0000 

DE=0000 

HL=0000 SP=0100 



IX-A4AE 

IY--FFFE 

01 0B 

2A0500 

LD 

HL,(( 

S0Z0H0P0N1 CO 

A--00 BC=0000 

o 

o 

o 

o 

II 

LU 

Q 

HL=52C3 SP=01 00 


I X=A4AF; 

IY^FFPE 

01 0E 

CDBD07 

CALL 

07 3D 

S0Z0H0P0N1C0 

o 

o 

o 

o 

il 

o 

CD 

O 

O 

II 

< 

o 

o 

o 

o 

ii 

LU 

o 

HL=52C3 SP=00FE 



IX=A4AE 

IY=FFFE 

07BD 

7C 

LD 

A, H 

SOZOHOPON1CO 

A=52 BC=0000 

o 

o 

o 

o 

II 

LU 

o 

HL=52C3 SP=00FE 



IX=A4AE 

IY=FFFE 

07BE 

B5 

OR 

L 

SI Z0H0P0N0C0 

A=D3 ec=oooo 

o 

o 

o 

o 

II 

LU 

Q 

HL=52C3 SP-00FE 



IX=A4AE 

I Y=FFFE 

07BF 

ca 

RET 

Z 
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6.3.2.14 De-Activate Trace Mode. [ U ] 

This command turns the Trace Mode Off so that subsequent execution occurs at 
full speed with no trapping. Entering a single letter "U" deactivates the 
Trace Mode . 


6.3.2.15 Write File to Storage. [ W ] 

This command is the complement to the Read command covered above. It assumes 
that the data to be written starts at 100H and writes the specified number of 
256-byte blocks to the file last specified with a "Name" command. The syntax 
of this command is: 

W[ ]#B1ocks 


6.3.2.16 Set Breakpoint. [ X ] 

This command is used to tag locations within the program to be executed under 
BPDBUG which, when executed, will temporarily stop executing and either return 
to the BPDBUG prompt or print information for the Trace output. Up to two 
breakpoints may be active at any point in time. The syntax is: 

X[ ]Address 


6.3.2.17 Clear Breakpoints. [ Z ] 

This command clears all breakpoints set with the X command cited above . 
Entering the single letter "Z." clears all breakpoints. 

6.3.2.18 Display On-Line Help. [ ? ] 

Entering a single Question Mark ("?") as a command displays the Build-In help 
display containing a summary of the commands available from within BPDBUG. 
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6.4 BPFORMAT - Floppy Disk Format Utility 

BPFORMAT is the general-purpose format routine for Floppy Disk Drives in the 
B/P Bios system. It automatically adapts to the specific hardware used in 
your computer to present a single interface across a wide range of platforms, 
and incorporates the ability to format disks in formats not implemented in 
your computer. This capability allows you to format disks for exchange with 
other users in their native disk format using the same library of alien disk 
formats used by the EMULATE program (see 6.8). 

This program is B/P Bios-speci f ic and will not function under other Bios 
systems. Its operation is the same under banked or unbanked systems, and with 
the many types of physical F)isk Controller integrated circuits available. In 
the initial version, the fol lowing Controller types are supported: 

765 1692 1770 1771 1772 1790 1791 
1792 1793 1795 2790 8473 9266 


6.4.1 Using BPFORMAT. 

6.4.1. 1 Built-in Formats. 

The simplest way of formatting diskettes is to use one of the formats included 
in the currently-running B/T' Bios . BPFORMAT may be invoked by simply entering 
the program name, or by following it with a drive letter and colon as: 

BPFORMAT D: 

Optionally, a Named di recto; y mto replace the drive letter and will format the 
drive associated with the named directory. For example, if a directory named 
WORK: is defined to be Drive C: . User 10. the command 

BPFORMAT WORK: 

would format Drive f : . Vhe:i invoked in cither of the above manners. BPFORMAT 
will list the built-in formats available for this drive from those included in 
the tiie DPR. LIP) (and optionally DPB2.LIB. see sections 4.J and 4.2). Only 
those formats which exactly match the drive characteristics will be presented, 
so only SO-track formats will be offered for an 80-track drive and so forth. 
For example, the offerings for a 40-track 5.25” disk drive may result in: 

Available formats are: 

A - Ampro DSDD B - Ampro SSDD 

Select format (~C to exit) : 

As precautions against inadvertently formatting diskettes, confirmation 
prompts are included as the program progresses, and the opportunity exists to 
escape from the format program to Command processor. An example appears at 
this point where a Control-C aborts the format operation. 
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6.4.1. 2 Library Formats. 

If formatting of a diskette is desired in a format not supported by the built- 
in selections featured in the executing Bios, the library of formats used by 
EMULATE (see 6.8) may be used. Reasons for using the library may range from 
the need to format in a mode used on another type of computer to a choice made 
internally unavailable by sizing constraints, as when tailoring a system for 
Boot Track installation. Whatever the reason, this flexibility is offered as 
an inherent feature of B/P Bios and is specified by specifying the L Option 
when invoking BPFORMAT. If specifying the desired drive on the command line 
as in either example above, simply add the option character at the end (with 
optional slash) as: 

BPFORMAT D: L 

If you wish to be prompted for the drive letter as part of the program flow, 
the slash becomes mandatory to inform BPFORMAT that you are specifying the 
Library option instead of Drive I:. The invocation thereby becomes: 

BPFORMAT /L 

When executed with the Library option, you will be presented with a menu of 
formats which may be used with the physical drive as defined in the Bios 
header. A sample display appears as: 

Available formats are: 

A - Actrx SSDD B - Ampro SSDD C - VT180 SSDD D - H- 100/4 ID 

E - H89/40 IS F - H89/40 ID G - H89/40 IX H - Kaypro 2 

I - Osborne IS J - Osborne ID K - Ampro DSDD L - H-100 DSDD 

M - H89/40 2D N - H89/40 2X 0 - QC-10 DSDD P - Kaypro 4 

Q - MD-3 DSDD R - PMC-101 S - Sanyo 1000 T - TV 802/803 

U - XBI0S-3 2D V - XL-M180 T2 

Select format ("C to exit) : 


Entering one of the letters corresponding to a format will set all parameters 
and proceed with the format operation. Entering a Control-C at this point 
will return you to the Command Processor at this point avoiding any inadvert- 
ent disk formatting. 

The Assembly source to the Format library is provided in the B/P Bios package 
as an aid in accepting formats not included in the default distribution pack- 
age. or to experiment with new formats. 

6.4.2 Configuration. 

Two options exist for custom tailoring BPFORMAT to operate in a method yuu 
find most comfortable. The first is a Quiet option which will minimize extra- 
neous output to the Console. It is set by a Boolean flag consisting of a Byte 
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at an offset of 11 (OBH) bytes from the beginning of the program. A Zero byte 
in this location signifies Verbose operation where all defined prompts and 
status information is displayed. A Non-Zero value (normally OFFH ) indicates 
that Console output should be minimized with only essential output displayed. 

The second option is for selection of the File Name and Type to be used for 
the Library of formats used with the L option. The default value of this 
entry is ALIEN.DAT (in formatted FCB form) which is also used with the EMULATE 
program. This field begins at an offset of 12 (OCH) bytes from the beginning 
of the program. 


6.4.3 BPFORMAT Error Messages. 

Must be wheel to FORMAT!!! 

As a safety feature, only users with Wheel privileges may format 
diskettes. This error message identifies an attempt without the proper au- 
thorization. 

*** ERROR ! Not B/P Bios, or Old Version ! 

In most cases, this error will be seen if an attempt is made to 
format a disk under a Bios other than B/P Bios. If some of the mandatory data 
structures have been altered, or if an attempt is made to run the release 
version of B/P Bios under one of the early test versions of B/P Bios, this 
message will also be displayed. 

*** ERROR ! The selected format is not supported by FORMAT! 

This error will be displayed if a format from a library of formats 
is incompatible with the specified drive, such as if a 5.25" format is select- 
ed for an 8" dri\e. 

*** ERROR ! The detected FDC is not supported by FORMAT! 

The Bios reported a Floppy Disk Controller (FDC) that is not in 
the list of Controllers supported by BPFORMAT. To view the list of con- 
trollers supported, view the internal Help by using the double-slash option. 

*** ERROR ! Disk is Write Protected! 

An attempt was made with the Write Protect Tab ON (for 5.25"), OFF 
(for S") or in the Protect position (3.5") for the specified disk. Set the 
disk to Read/Write by altering the physical setting and try to format the disk 
again . 


*** ERROR ! Disk won’t recalibrate 

The drive heads could not be restored to Track 0 position. This 
error is often due to a failure in the drive mechanism, but can also be caused 
by deformed diskettes or loose drive cable. 

Format Error : xx 

An error was detected during the format process. The "xx" will be 
the Hexadecimal byte returned by the Bios portion of the format routine, and 
bits set to a "1" value should represent an error code decipherable from the 
FDC Data or programming sheet. 
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+++ Can’t Open : fn.ft 

BPFORMAT could not open the format library file. To access a 
format library, it must either be in the default library, or accessible from 
it either via the PUBlic bit or along the ZSDOS path. 

No formats available for this drive! 

This error will be reported if no formats (internal or from a 
format library, depending on how it was invoked) are supported on the speci- 
fied drive. For example, if all internal formats are for 5.25/3.5” drives and 
the target drive is specified as an 8” drive, then no formats will be avail- 
able if BPFORMAT is invoked using the internal format method of operation. 
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6.5 BPSWAP - Logical Disk Swap Utility 

This utility al'ows you to exchange the drive letters defining two logical 
drives or partitions within the system. It performs any operations necessary 
to properly adjust the Operating System to account for drive redefinition, and 
relogs both drives using Dos Function 37 to force rebuilding of the Allocation 
Bit Map. 

BPSWAP is a B/P Bios utility and will not execute under any other system. It 
may be operated in an interactive mode, fully "expert” mode with arguments 
passed on the command line, or a combination where the first drive letter is 
passed on the command line and the second entered in response to a query. If 
running in the interactive mode, entering a Control-C instead of a drive- 
letter will interrupt the program and return to the Command Processor. BPSWAP 
is re-executable under ZCPR with the "GO" command. 

6.5.1 Using BPSWAP. 

6. 5. 1.1 Interactive Operation. 

To execute BPSWAP in l he interactive query /'response mode . simply invoke th_ 
program by entering its name as: 

BPSWAP 


The p 

a g rat: v. ill i m- 1 1 >_ 

the 

i the syst 

cm j s 

dial a 

r on, the operating 

e-m 

j ronmtnr . 

and d 


First 

Drive to Swap 

[A.. 

At tii 

is point, a drive 

let 

ter (upper 

o r 

the S] 

xrcifitd range of 


through 

r" . 

Com rt 

U-c which aborts 

t he 

pro? ran, . 

wj ; i 

f i rx 

dr he letter. \\ 

hen 

a valid c 

r i v e 

1 i km. 

s e re q a e s t e c! v, i 1 1 •> 

t .’";0 

prompt : 



running a B/P B.cs . gather 
i splay the prompt: 

P3 : 

lowercase ) should be enter-. 
All invalid characters, e: 
result in repeated pros.; i- 
letter is detected . the s 


in : ern 


Second Drive to Swap [A..P] : 


BpSV.AP respond'-, to entries at this point in an identical manner to the first 
repeatedly prompting for a valid letter, or the abort character. When a va ) i 
letter is received, each logical drive is reassigned to the physical def ini 
t ions of the other’ . 


6.5. 1.2 Command Line Operation. 

BPSWAP can accept and parse drive letters passed to it on the Command Line in 
order to include drive exchanges in Startup scripts or other alias command-. 
To invoke the program in this manner, enter the program name with two drive 
letters m the range of A through "P" with a delimiter between each fielo. 
Each ot the drive letters may be followed by an optional colon. De 1 imi t me 
characters, are TAT . space . and Comma . A summary of the complete syntax is: 

BPSWAP <Drv1>[:] <tab! , > <Drv2>[:] 
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To illustrate, the following are valid commands executing BPSWAP: 

BPSWAP A: E: < — Exchange E drive with A 

BPSWAP D,H < — Exchange D drive with H 

If an invalid character is detected for either or both of the drive letters 
when called in the Command Line mode, operation automatically reverts to the 
Interactive mode and the respective prompt(s) will be given for valid drive 
letter(s). This feature permits a hybrid mode of operation to be specified 
wherein the first drive letter is passed on the Command Line, and the second 
entered in response to the second drive prompt. 


6.5.2 BPSWAP Error Messages. 

The only error message which may be printed by BPSWAP is in response to inter- 
nal routines which validate the presence of a B/P Bios. Any attempt to run 
this utility on other Bioses results in the error: 

+++ Not B/P Bios ... aborting +++ 

after which point the program aborts and control returns to the Command Pro- 
cessor. No effect on drive allocations will occur if this error is displayed. 
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6.6 BPSYSGEN - System Generation Utility 

BPSYSGEN is our generic version of the classic SYSGEN program used to place an 
executable system image onto the boot sectors of a Floppy or Hard Disk. It 
uses information provided by the Bios in the form of DPB/XDPB data (see 5.2.3) 
which defines the physical and logical drive characteristics to write system 
information from the system tracks of one drive to another, or from an image 
produced by MOVxSYS (see 6.16) to the boot tracks of a drive. 


6.6.1 Using BPSYSGEN. 

6.6. 1.1 Interactive Operation. 

The basic Interactive mode is initiated by simply entering the program name at; 
the Command Line prompt as: 

BPSYSGEN 

You will first be prompted for the source drive from where to obtain a boot- 
able system image, then for a destination drive to save the image. To provide 
a visual clue that the program is executing, a series of periods is printed on 
the screen with each period representing a physical sector of data. At the 
conclusion of the operation, the program exits to the Command Processor 
prompt . 

A binary file produced by MOVxSYS (see 6. 16) may be placed, on the systen 
tracks of a hard or f loppy disk by specifying the file name as a command line 
argument as: 

BPSYSGEN B: ZSD0S64.BIN 

When activated in this manner, you will be prompted for the destination drive 
letter after BPSYSGEN loads the image file and validates it as a valid system 
image. Alternatively, you may replace the file name with a drive letter 
followed by a colon to automatically load the image from a specific drive, and 
be prompted for the destination drive. 


6. 6. 1.2 Command Line Operation. 

A single operation may be completely specified from the command line arguments 
thereby avoiding drive prompts. When invoked in this manner, the first argu- 
ment specifies the source for the system (drive designator or file) with the 
second argument being the drive specification on wfiich to place the bootable 
system image. The syntax for the Command Line method of operation is: 

BPSYSGEN { d : J fn[.ft]} d: < — d is drive in [A. .P] 
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6.6.1 BPSYSGEN Error Messages. 

*** Read Error 

An unrecoverable error was encountered reading either the boot 
tracks of a drive, or a specified bootable file. 

*** Bad Source! 

The source drive does not exist or could not be selected. 

*** Write Error 

An unrecoverable error was encountered writing the boot tracks of 
the specified destination drive. 

*** Bad Destination! 

The destination drives does not exist or could not be selected. 

*** No System! 

There are no valid System Tracks on the Source or Destination 
Drive, or an anomalous condition (more than 3 reserved tracks) 
was detected. 

*** Can’t Open Source File! 

The specified boot image file could not be located, or an error 
occurred during the attempted File Open. 
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6.7 COPY - Generic File Copy Utility 

COPY.COM is a file copy program derived from the ZCPR3 MCOPY tool written by 
Richard Conn. It blends the many modifications by Bruce Morgen. Howard Gold- 
stein and others in MC0PY4S with further enhancements in the spirit of the 
ZSDOS environment. File date stamping is supported for the full range of 
stamping capabilities provided by ZSDOS. A user-definable "Exclusion list" is 
now supported to prevent copying of specific files or file groups, and two 
options to ease file backups with the Archive bit have been added. COPY is 
also more user-friendly than MCOPY, and provides increased error checking and 
user feedback. 

COPY only operates in the Command Line Driven or Expert mode. As with the 
other utilities provided with ZSDOS, COPY displays a short Help message when 
invoked with a double-slash argument as explained in Section 1.2. The Help 
message also includes a list of available options along with the effect of 
each when included as command line arguments. 

While COPY is ready to run without special installation procedures, you may 
wish to change the default parameters to customize it to your operating style. 
In this manner, you can minimize the number of keystrokes required to perform 
routine operations by avoiding passing many options on the command line. To 
set default conditions, insure that COPY.COM. COPY. CFG and ZCNFG.COM and 
available to the system, and execute ZCNFG as described in Section 4.8 of the 
ZSDOS 1.0 Manual. 


6.7.1 Using COPY. 

The basic syntax for COPY follows the original CP/M format by listing the 
destination drive/user, an equal sign, then the source drive/user and file 
name. An alternate syntax added by Bruce Morgen in MC0PY4S permits specifying 
transfers in the "Source-Destination" form popularized in MS-DOS. In this 
alternate form, you first enter the source drive/user and filename, a space, 
and then the destination drive/user and optional filename. Using the normal 
symbology, the syntax is summarized as: 

COPY dir: [fn, f t]=[di r : ] fn . f t , . . . [/joptions 

or 

COPY [di r : ]fn. f t dir:,... [/joptions 

If no destination filename is specified, a number of unique files may be 
copied to a specified directory by catenating source files separated with 
commas . Where a destination file name is specified, both source and destina- 
tion file names and types must be free of wildcard characters. This popular 
"Rename" feature in a copy was a much requested addition to the ZSDOS copy 
utility. Options to tailor the actions of COPY may be appended after the 
source f i le 1 ist . 

Yet another method of transferring files was retained from the original MCOPY 
roots. II no destination drive/user is recognized in the command line argu- 
ments. all referenced files will be copied to a default drive/user location 
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which is contained in the header portion of COPY. The default location is 
Drive B. User 0 in the distribution program, but may be changed as described 
below. If options are desired with this syntax, the slash option delimiter is 
Mandatory. The syntax for this method is summarized as: 

COPY [dir:]fn.ft, . . . /options 

Various configuration options detailed later allow you to customize COPY to 
suit your operating style. For example, status displays of each operation may 
be suppressed for a "Quiet" mode, verification that copied files match the 
original (or at least produce the same error check code) may be enabled or 
disabled, etc. If a method of Date and Time Stamping is active under ZSDOS. 
the original Stamp information will be transferred to the destination file. 
The following examples in the "Verbose" method of operation will serve to 
illustrate by copying a file from the current Drive and User area to the same 
drive. User 10. 

COPY ZXD.COM 10: 

COPY Version 1.71 (for ZSDOS) 

Copying C2:ZXD .COM to CIO: 

-> ZXD .COM.. Ok (Dated) Verify.. Ok 
0 Errors 

In this case. No file of the same name existed in the destination area, but 
some form of File Stamping was active, so the source Stamp information was. 
successfully transferred to the destination. Performing the same activity 
with the other syntax now produces: 

COPY 10:=ZXD.COM 

COPY Version 1.71 (for ZSDOS) 

Copying C2:ZXD .COM to CIO: 

-> ZXD .COM Replace Same (Y/N)? Y. .Ok (Dated) Verify.. Ok 
0 Errors 

Since COPY now detected a destination file of the same name, and File Stamping 
as well as duplicate checking (another option flag) were in effect, COPY 
compared the Last Modified dates for both source and destination files. 
Finding a match, the prompt "Replace Same" was issued, and received a (Y)es 
response to copy the file anyway. Other responses, depending on the results 
of the date comparison are "Replace Older", which means that an older file 
exists on the destination, and "Replace Newer" which means that you are trying 
to replace a newer file on the destination with an older version. 

A similar error check is made if a duplicate file is found to determine if the 
file was found with the PUBlic Attribute bit. If a Public file is detected on 
the destination drive, a warning to the effect is printed. Answering Yes to 
replacement at this point will result in a Read-Only error unless ZSDOS has 
been set to permit writes to Public Files (see 2.S.3 of the ZSDOS 1.0 Manual). 

As stated earlier. COPY has no Interactive mode of operation per se . but the 
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Inspect option provides a means to select files for transfer in a somewhat 
interactive manner. In this mode, all files selected by the file specifica- 
tion in the command line are displayed, one at a time, and you may enter "Y" 
to copy the file. "N" to Not copy the file, or "S" to forget the rest of the 
selected files. An example copying all files from the current Drive and User 
to User 10 is: 

COPY *.* 10: /I 

COPY Version 1.71 (for ZSDOS) 

Copying C2 :????????.??? to CIO: 

Inspect — Yes, No (def), Skip Rest 
BUI 6 .COM - (Y/N/S)? Y 

BUI 6 . MZC - (Y/N/S)? N 

COPY .COM - (Y/N/S)? Y 

COPY . Z80 - (Y/N/S)? S 

If operating in the Verbose mode, status on each file will be printed as the 
copies progress. 


6.7.2 COPY Options. 

Several option characters are available to customize COPY operations. Most of 
these options may be set as default conditions using Al Hawley's ZCN'FG Config- 
uration Utility. Alternatively, you may enter any of them on the command line 
to alter the functions of a single operation. The command line option charac- 
ters art as follows: 

A - Archive 

E - Test for File F^xistence 

I - Inspect Files 

M - Multiple Copy 

N - No replacement if File exists 

0 - Test Existence of R/O Files on Destination 

Q - Quiet 

S - exclude System Files 
V - Verify 

X - Archive Only if File exists 

From the brief syntax summaries listed above, you will note that the standard 
option delimiter, a slash, is optional if both source and destination specifi- 
cations are listed on the command line. If only one specification is listed, 
is when copying to the default drive, the delimiter is Mandatory. Each option 
is described in the following paragraphs. 

6.7.2. 1 Archive Option. 

When this option is active either by specifying in the command line or as a 
default, only files which do Not have their Archive Attribute set will be se- 
lected. After the selected files are copied, the Archive Attribute on the 
Source file will be Set to indicate that the file has been "Archived". When 
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used in conjunction with the default drive and user settings, the A option 
provides a simple method of archiving files in a single user area. The de- 
fault for this option is Off , for No control of selection by the Archive 
Attribute. Adding the A option to the command line reverses the configured 
setting. 

It should be noted that this option is incompatible with the "M" (Multiple 
Copy) option. The first copy operation will set the Archive bits on selected 
files, and they will not appear in subsequent copies. 

6.7.2.2 File Existence Option. 

This option controls the test for an already-existing file on the destination 
drive by the same name. Adding the E option to the command line argument 
reverses the configured setting. The default in the ZSDOS distribution ver- 
sion is On. or Check for Existing files. This option does not affect the 
check for PUBlic files on the destination drive, which is always active. 


6.7. 2. 3 Inspect Files Option. 

As illustrated previously, the I option provides a means of selectively copy- 
ing files, without entering the name of each file. The distribution default 
for this option is Off, or do Not inspect the selected file list. Specifying 
this option on the command line argument list reverses the configured setting. 


6. 7.2.4 Multiple Copy Option. 

This option may be used to copy a file, or group of files to the same drive 
several times, as when making several copies of the same file group on differ- 
ent disks. A prompt is given before each copy operation begins, and you may 
abort at the prompt, or change disks before beginning the cop}-. The distribu- 
tion default for this option is Off. for No Multiple copying. Adding the M 
option to the command line argument list reverses the configured setting for 
this option. 


6.7. 2.5 No Replacement Option. 

When added as a command line argument, the N option will not allow replacement 
of a file which already exists on the destination Drive/User. This option 
cannot be configured, and always assumes the same initial state when C0P1 is 
called. The default initial state for this option is Off to permit replace- 
ment of existing files. 


6.7. 2. 6 Read-Only File Test. 

This option, when added as an argument, reverses the configured setting of a 
flag which checks for the existence of filets) satisfying the specified name 
and type with the Read-Only attribute set. If this flag is active and a Read- 
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Only file is located satisfying the criteria, the file will not be automati- 
cally overwritten. The E (File Existence) flag will still dictate how other 
files are handled. 


6.7.2.1 Quiet Option. 

When used on a system with ZCPR3, this option causes a reversal in operation 
of the ZCPR3 Quiet flag. If the ZCPR3 Quiet flag is active. COPY with the Q 
option operates in a Verbose mode. If you do not use ZCPR3, or the ZCPE3 
Environment defines the Quiet flag as inactive, this option will disable 
unnecessary console messages for a Quiet mode of operation. There is no 
default condition for this option, and it is only effective for a single call 
of COPY. 


6.7. 2.8 System Files Option. 

This option controls whether or not files with the SYStem Attribute set will 
be located by COPY. The distribution default is Off to include SYStem files 
in COPY file lists and permit copying of such files. The default may be 
configured as described below, and the default may be reversed by adding an S 
in the command line option list. 


6.7. 2. 9 Verify Option. 

To add a measure of confidence that no errors occurred in a COPY operation, 
the Verify option may be activated. When active, the destination file is read 
in order to compute a cyclic Redundancy Check (CRC) word. This word is then 
compared to a value calculated when reading the source file. If the two 
values match, you can be reasonably sure that the destination file is a true 
copy of the source file. The distribution default for this option is True to 
verify each file copied. This option may be changed by configuration, or 
reversed by adding a V to the command line option list. 


6.7.2.10 Archive if Only if File Exists Option. 

Occasionally, you may wish to update frequently archived files to the same 
destinations in a simpler manner than naming each file, or by using the In- 
spect option. The X option was created for just this purpose. When this 
option is added, COPY first searches the source directory for files which have 
not been archived, then checks the destination directory for each file. If a 
match is found, the file is copied, and the source file deleted, unless it is 
marked as Read-Only. There is No configurable setting for this option which 
is always assumed to be OFF when beginning COPY. 
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6.8 EMULATE - Alien Disk Emulation Utility 

EMULATE locks any or all Floppy Disk Drivels) to specified formats, native or 
alien, from a Database of formats. It may also be used to display current 
settings and restore drives to auto-selection if the Bios was assembled with 
the AutoSelect option (see 4.2). The Floppy Disk format information is con- 
tained in a file named ALIEN.DAT whose use is shared with BPFORMAT (see 6.4). 
This sharing of a common database of formats allows formatting, as well as 
reading and writing of a large number of the hundreds of formats used by CF J /M 
vendors over the years. 


6.8.1 Using EMULATE 


This utility is only usable with B/P Bioses which have been assembled with the 
Auto-Select option (AUTOSEL) active. This is the normal mode for release 
versions of B/P Bios, although some versions placed on the boot tracks of 
floppy disks may have a scaled-down complement of built-in formats to reduce 
the system image size (see 4.3). EMULATE can be executed either in an inter- 
active query/response mode or in a command line "expert" mode with arguments 
passed on the command line. The EMULATE syntax is: 


EMULATE // 

< 

EMULATE [/]X 

< 

EMULATE t/]U 

< 

EMULATE 

< 

EMULATE d[: 3 

< 

EMULATE d[ : ] [nn] 

< 


Print Built-in Help Summary 
List Current Floppy Format Settings 
Return All Floppies to Autoselect 
Execute in interactive Query/Response mode 
Select formal of Dr ire d: interactively 
Set Drive d: format to entry nn (expert) 


To keep the numbering of formats in the Database file constant, thereby allow- 
ing the expert mode of coni' i sural ion. all format s in the .ALIEN'. DAT tile are 
loaded without validation against the actual drive parameters. Once a format 
is selected, the required drive characteristics (disk size, nun.be r of sides, 
speed and number of tracks) are compared to the physical drive parameters 
contained in the B/P Bios header structure (see 5.2.1. CONFIG+35 ) . I; the 
selected format can lx accommodated by the physical drive, then the format 
information is loaded into the Extended DPH/DPB fields for the specified drive 
and the format locked to prevent re-assignment on warm boots. 

The following formats are currently included in the ALIEN.DAT file, the source 
code for which is included in the distribution version of B/P Bios as 
ALIEN. LIB: 


1 

Actrx SSDD 

2 

Ampro SSDD 

3 

VT180 SSDD 

4 

H- 100/4 ID 

5 

H89/40 1 S 

6 

H89/40 

ID 

7 

H89/40 IX 

8 

Kay pro 2 

9 

Osborne IS 

10 

Osborne 

ID 

11 

Ampro DSDD 

12 

H-100 DSDD 

13 

H89/40 2D 

14 

H89/40 

2X 

15 

QC-10 DSDD 

16 

Kaypro 4 

17 

MD-3 DSDD 

18 

PMC-101 


19 

Sanyo 1000 

20 

TV 802/803 

21 

XBIOS-3 2D 

22 

XL-M180 

T2 

23 

Ampro SSQD 

24 

DEC Rainbo 

25 

Eagle-IIE 

26 

H89/80 

ID 

27 

H89/80 1 X 

28 

Ampro DSQD 

29 

Amstrad WP 

30 

H89/80 

2D 

31 

H89/80 2X 

32 

XBIOS-4 2Q 

33 

CCS SSDD 

34 

IBM 3740 

35 

Bower 8”1D 

36 

TTek SSDD 

37 

Bower 8 "2D 

38 

CCS DSDD 

39 

TTek DSDD2 

40 

TTek DSDD1 
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Current drive format allocations may be examined at any time with the X option 
which will list the 10-character name the format assigned to each floppy drive 
in the system, or state that it is Autose lect ing. The U option removes all 
fixed formats, returning them to Autoselecting. 

6.8.2 EMULATE Error Messages 


+++ Can’t Open Database File +++ 

EMULATE could not locate the ALIEN.DAT file in the currently 
logged directory. Solutions include setting the PUBlic attribute of ALIEN'. DAT 
and insuring that the Dos Path includes the drive containing the file. 

+++ Format Not Supported on this drive! 

Self-explanatory. Common causes of this error are selecting an 
80-track format on a 40-track drive, or an 8" formal on a 5.25” drive. Check 
the ALIEN. DAT source code to determine any needed data on the exact drive 
requirements for each format. 
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6.9 HDBOOT - Hard Drive Boot Utility (tailored) 

HDBOOT is a specialized routine which is only available for those computers 
which feature the ability to boot from Hard Drives from a cold start such as 
the YASBEC and Ampro Little Board computers in the initial version. HDBOOT is 
a customized utility which is tailored for specific versions and will not 
execute on B/P Versions which it does not recognize. It modifies the boot 
record of a Floppy Disk System image placed on a drive by BPSYSGEN (see 6.6) 
to allow the system to be started from the Hard Drive at power-on or from a 
system Reset. 


6.9.2 Using HDBOOT 

HDBOOT is extremely simple to use, and accesses the B/P Bios Data structures 
of the target system for any system-specific data required, such as initiali- 
zation parameters for the Shugart /'Xebec controller types. When invoked, the 
existing system is checked to insure that it is a valid B/P Bios version. If 
valid, you will be asked to specify which of the three possible physical SUSI 
units to access, and from there on the operation is automatic. A sample 
screen for a successful execution of this utility is: 


B/P HDBOOT Utility VI. 0 31 Aug 92 

Copyright 1992 by H . F , Bower/C .W . Cotri 11 

Configure whicn unit for 8ooting [0..2] : 0 

Target Controller is : Seagate SCSI 
...Reading Boot Record. . . 

...Writing Boot Record... OK.. 

AO: BASE >_ 


It should be noted that a system must have been placed on the target unit with 
BPSYSGEN (see 6.6) before executing this utility, or an error message will b<_ 
issued and the operation aborted. 


6.9.3 HDBOOT Error Messages 


*** No System! 

The specified target Unit does not contain a valid Boot System. 
Place a valid Boot Track system on the unit with BPSYSGEN and execute HDBOOT 
again . 

*** Invalid Unit Number *** 

The Unit number speed tied on the command line is invalid. Either 
it is not "0". " 1 ” or "2". or the unit is not active. 
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*** Invalid Boot Record *** 

The Boot Record existing on the specified Unit is not valid for 
this type of Computer. Normal causes are no system currently exists on the 
specified unit or the system in place is not a valid one for this system. 
Both of these may be corrected by placing a system on the first physical 
partition of the unit with BPSYSGEN (see 6.6) 

+++ Image is Not B/P Bios, or Wrong Version +++ 

The image read from the Boot Tracks of the specified system was 
not a valid version of B/P Bios. The two most common causes of this are: not 
placing a Boot System on the System Tracks with BPSYSGEN. or altering the 
fixed data structures of the Bios source code in a way which violates the 
standard layout resulting in a system which cannot be recognized. 

+++ Unit Not Active! Run BPCNFG to Set Drives. 

The specified Hard Drive Unit (0, 1 or 2 ) was not tagged as an 
active unit. This can be changed by first executing BPCNFG (see 6.2) on the 
executing memory system, then re- invoking HDBOOT. 

+++ Not B/P Bios ... aborting +++ 

An attempt was made to execute this utility on a system which was 
not running under B/P Bios. Boot the system with a R/P Bios-equipped system 
and try again. 

*** Read Error 

An unrecoverable error occurred while trying to read the tareet 
system's boot Record. This is most often due to media errors on the first 
cylinder of the target unit and cannot be rectified. Another cause may be an 
incorrect definition oi the physical characteristics of the controller and/or 
dr i vc . 

*** Write Error 

An unrecoverable error occurred while trying to write the modified 
Boot Record to the Hard Di ive unit. If a second attempt at execution is 
unsuccessful . it probably indicates either an incorrect physical definition of 
the Hard Dritc unit, or unrecoverable media errors on the first cylinder of 
the drive. 
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6.10 HDIAG - Hard Disk Format/Diagnostic Utility 

HDJAG is a generic B/P Utility program to Run Diagnostics, Format. Verify and 
examine Hard Drive parameters using any of the defined controller types in a 
B/P Bios system where such capabilities are defined. The ability to select 
the controller type in the beginning of the program is allowed to enable you 
to check and initialize drives using controller types other than that defined 
in the executing Bios for added flexibility. The following controller types 
are handled in the initial B/P Bios release: 

Adaptec ACB-4000A 

Shugart 1610-3 / Xebec 1410A 

Seagate SCSI 

Shugart 1610-4 (Minimal SCSI) 

SCSI-2 subset for Conner and others 


6.10.1 Using HDIAG 

This utility tool only operates in an interactive mode, so it is simply in- 
voked with its name and no arguments (other than the standard double- slash 
Help request). When activated, it reads the controller type from the B/P Bios 
header structure and asks you if this is the controller type you wish to use. 
If you wish to use a different controller type, such as diagnosing a Seagate 
SCSI drive from a system which has an Adaptec controller for normal use. you 
may alter the control lei' def inition for the remainder of the HDIAG session. 
The interaction through to the main loop prompt may appear as: 


B/P Bios Hard Disk Utility VO. 6, 25 May 92 


Controller = Adaptec Ok ([Y]/N) ? : N 
[0] Owl, [1] Adaptec, [2] 1410/1610-3, [3] SCS1 1 , [4] 1610-4, [5] SCSI2 : 5 


Functions: 


F - Format 
V - Verify 
D - Run Diagnostics 
P - Show Disk Parameters 


Select (~C or ESC to Quit) : 


6.10.1.1 Show Disk Parameters. [ P 3 

If you are running HDIAG on a Hard Drive Unit which is already defined in the 
Bios and was previously formatted, or one of the self-identifying SCSI drives, 
then you may view the current drive parameters with the P command. The dis- 
play varies with the controller type and the amount and type of information 
that is available. Some of the data may be from Bios definitions, and other 
data from either the controller (e.g. Adaptec) or the drive electronics (SCSI 
or SCSI-2). Samples of the forms of information are: 
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Unit : 0 CONNER CP3100-100mb-3.5 <— SCSI! setting 


Total Blocks 
Sctrs/Track 
Sector Size 
Interleave 
# Cylinders 
Num of Heads 


204864 (12804 Eq. Tracks) 

33 
512 
1 

776 

8 


Unit : 0 


< — Adaptec ACB-4000. Syquest SQ-312 10 MB 


Total Blocks 
Sctrs/Track 
Sector Size 
# Cyl inders 
Num of Heads 
Reduced Wrt. 
Precomp. Cyl 
Step Rate 
Media type 
Landing Zone 


22140 (1383 Eq. Tracks) 

18 
512 
615 
2 

615 

615 

12 uS Buffered 
Removab 1 e 
615 


6.10.1.2 Hard Disk Diagnostics [ D ] 

Some drives feature built-in diagnostics routines which test the unit's elec- 
tronics and media. Other systems simply execute the power-up sequence which 
generail} includes a sequence of self-tests. Normally, only the i e- ini t i a 1 i ze 
function can be. relied on. and is included in the standard suite of HD I AG 
functions with this command . Samp 1 e output resulting from this function is: 

Select (~C or ESC to Quit) : D 
Unit Number [0..2] ( ~C or ESC to Abort) : 0 
Re-Initializing Unit : 0 ..Ok 
..Waiting for Ready.. 

Pauses may occur in the execution of the sequence . most noticeably after the 
status prompt stating "Re-Initializing Unit" before the "..0k" appears. 
Depending on the exact system, this time is often when the actual controller 
electronics are being checked, and may involve moving the drive head which can 
be a time consuming task. There is also a pause very often after the prompt 
..Waiting for Ready..", particularly if the heads were moved and must be re- 
positioned over the outer cylinder of the drive. When the drive returns a 
ready status, then the main selection menu is again displayed and HD I AG is 
ready for another command. 

6.10.1.3 Verify Drive Media [ V ] 

This function permits evaluating the condition of a formatted drive to identi- 
fy defects to a varying extent. By using a mix of defeating the Error Cor- 
recting code where possible, and enabling or disabling the Individual Sector 
checks, a relatively extensive, albeit often time consuming, non-destruct ivt 
status of the drive unit may be obtained. 
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Select ( ~C or ESC to Quit) : V 
Unit Number 10.. 2 j ( or ESC to Abort) : 0 
Verify Individual Sectors (Y/lN] ) : N 
Verifying Unit : 0 CONNER CP3J00-100mb-3.5 


Block 891 

. . .aborted. . . 

6.10.1.4 Format Drive [ F ] 

Setting all of the data storage areas on the disk to a constant value, and 
renewing the control information on the drive is the purpose of this function. 
It is destructive, and any data on the drive will be lost. For this reason, 
several checks are included in the program to insure that you do not inadver- 
tently activate this command. 

while most of the information needed to format a drive is available from 
either the built-in data which can be read from the drive or controller, or 
from the Bios data areas, some items are still required from the user. You 
will therefore be asked to provide any data necessary to format the drive. In 
the older S.AS1 systems (1610-3. Xebec, etc) this can amount to a considerable 
number of entries. Fortunately, formatting of drives is not often required, 
and the method of formatting user: in HD I AG is flexible enough to allow a wide- 
range of devices to be connected. 


6.10.2 HD I AG Error Messages 

Several error messages wili be presented for specific problems encountered in 
the operation of HD I AG. Many of the messages will be specific to certain 
operations, and others will change the specific information depending on the 
capabilities of the controller type selected. The most general of these 
concerns the SCSJ/SASI Sense command . The Newer SCSI systems use Extended 
Sense" which can return more information than the basic Sense values. When 
Extended Sense is detected, the "Key” value is displayed in many error messag- 
es rather than the basic "Sense" byte. Consult the programming manual for the 
specific controller or drive for the specific meanings of these bytes. Such a 
message will usually be displayed as: 

Error! (Comnd = xx) Sense: xx 
or Error! (Comnd = xx) Key = xx 

Also, to provide additional information during operation of many of the func- 
tions. the raw status byte read from the controller when an error occurs is 
also displayed as part of an error message as: 

(status = xxH) 


The interpretation of the hexadecimal byte presented may be gathered from the 
programming manual for your specific drive or controller type. 
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+++ Not B/P Bios ... aborting +++ 

An attempt was made to execute HDIAG under a Bios other than B/P. 
or modifications made to the Bios altered the locations or values needed to 
correctly identify the system. 

**** SCSI Block Length Error i 

This fatal error message will be displayed if the Command Descrip- 
tor Block returned from the Bios is too small to allow the extended commands 
needed for the requested operation. It usually results from alterations to 
the Hard Driver module which change necessary values. 

**** Controller Not Readable ! 

HDIAG could not read parameters from the drive or control lei'. 
This will only appear in the R (Read Drive Parameters) function, when the 
controller type is "Owl”. 

**** No Diagnostics for : <contyp> 

The Controller selected cannot perform Diagnostics in a way that 
HDIAG can access or perform the needed functions. This will only appear in 
the D (Perform Diagnostics) function. 

**** Verify Not Available ! 

The specific drive/controJ ler selected has. not been defined ade- 
quately to al low verification of the drive. This will only appear in the V 
(Verify) function when the control J c-r type is ”0w!". 

+++ 1610-3 Initialization Error .. .Sense = xxH 

An error was detected sending the initialization string to a 
Shu. cart 1610-3 or Xebec J 4 i 0 A controller. Insure that this is the correct 
type oi control ler setting for your hardware configuration. It will only 
appear in the V (Verify! function. 
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6.11 INIRAMD - RAM Disk Initialization Utility 

INIRAMD is a B/P Bios utility that initializes the Directory of a RAM Drive 
and optionally initializes it for DateStamper (tm), P2DOS. or both types of 
file stamps. It contains protective features to preclude inadvertent initial- 
ization of an already formatted RAM Disk, and may be command line driven for 
execution from within STARTUP scripts. 


6.11.1 Using INIRAMD 

This utility is designed to be operated with Command Line arguments, but 
features built-in defaults which can be configured by either overlaying bytes 
in the beginning of the program with new default settings, or by configuring 
with Al Hawley's ZCNFG tool. To execute with the default settings, simply 
enter : 

INIRAMD 

The complete syntax for INI RAMI' is: 

INIRAMD [d : ] [/] [Q] [D] [P] 


6.11.2 Command Line Mode 

By entering arguments on the command Line when INIRAMD is invoked, several 
interna] default values can be set to the specific settings desired at the 
time. The first argument expected when parsing the Command Line tail is a 
Drive Letter. This is optional and will override the default drive M: built 
into the program. To spec i f v . drive other then the default , enter: 

INIRAMD d: 

Extraneous prompt and status messages can be withheld during execution to 
INIRAMD by either setting the default "Quiet" flag embedded in the program, 
setting the "Quiet" flag in the Environment, or passing a Q as an argument 
when invoking the program. Initializing the RAM Drive in Quiet mode using trie- 
default drive is then accomplished by entering: 

INIRAMD Q 

You may also specify which types of Date/Time Stamps to add to the RAM drive 
during preparation with the P (for P2D0S Stamps) and/or D arguments. If not 
operating in the Quiet mode. INIRAMD notifies you which type(s) of Stamping 
methods have been added to the RAM Drive after the directory area is initial- 
ized to a blank value. Initializing drive M: for both types of Stamps then is 
initiated by entering: 

INIRAMD M: PD 
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INIRAMD Error Messages 

+++ Not B/P Bios ... aborting +++ 

An attempt was made to execute HD1AU under a Rios other than it/!'., 
or modifications made to the Bios altered the locations or values needed to 
correctly identify the system. 

+++ Already Formatted. . .Proceed anyway (Y/[N]): 

This warn in? and prompt will be issued if INIRAMD detected the 
dummy file name used as a tap that the RAM Drive is already formatted. This 
is most often seen in systems that contain battery backed-up RAM and INIRAMD 
is invoked either directly or in a Startup alias script. To minimize i hr 
appearance of this message if you desire to have the RAM Disk initialized li- 
the Startup script . include the fol lowinp: 

IF EX M : -RAM . 000 < — Assume RAM Disk is 

INIRAMD M: < — Assuming RAM Disk is M : 

FI 

+++ Drive d: does NOT Exist 

F. i ther tii e del a it 1 1 o r e x p 1 i c it dr i v e spe c i tie d i n a c t i v a t in 

INIkAMp was has not been defined to the system. One possibility is that the 
RAM Drive was swapped for an undefined drive letter. Check the drive assierv- 
nieut-- with Bi'cyro. opt ion 5 if you wish to check the Drive assignments. 

+++ Drive d: is Not a RAM Drive! 

Either the default or ex pi i ci t drive specifier i n act : v<o : n 

INIRAMD was a valid drive, but was not a RAM Drive. As with t he pi evioir 

error . one possib: I ity is th.r.t th-. RAM Drive was swapper; t r ano i he r d ■ i \ 

which was of another ivpr. . i so MP( 'NFO . Opt i on 5 to check the Drive ess ipt> 
ment s . 
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6.12 INITDIR - P2 Do? Stamp Initialization Utility 

INITDIR prepares disks for P2lJGS-type file stamping. It does this by replac- 
ing every fourth entry in the disk's directory tracks with a time and date- 
entry which is prefixed with a special character (hexadecimal 21). Existing 
directory entries in the fourth position are then shifted to the first entry 
in the next logical sector and the initialized directory sectors are written 
back to the disk. 

* * * * * * * * * * * * * * * * * * * * X :j. \V J (3 ******************* * * * * 

* IN III) IK should not be run on disks containing valid Date- * 

* Stamper file stamps since it rearranges directory data. * 

* To install both DateStamper and P21X)S stamping on one * 

* disk, start with a blank disk, or one with no da test amps * 

* of either type and rur. both PUTDS and INITDIR on the disk * 

»• before using it. Doing otherwise will invalidate any * 

* existing stamp data. * 

* * * ****** * * * * * * * * * * * * * * * * * * * ******* } * * * * * * * * * * * * * >: * * * * * * * * * * * 


6.12.1 INITDIR Interactive Mode. 


Initdir can be run : a c j t ne r an interact ive mode by simply entering its nan.'., 
at the Command Promt- 1 . or in 'Expert Mode’' by spec i lying a drive letter as as 
argument on the command line. in t he interact ice mode, you win be aske-l i- ■' 
a drive letter which mil specify the drive to initialize with P2U)s stamps . 


If the Da t eh tamper ’■ ! ! TI tfivv . DA'' file is detected or the disk, lMU.dK issues a 
warning and asks i 1 you ward, to proceed or not ( see (>.I2.2 below). To avoid 
the possibility oi toss cd T i n.e and Date St amp information from Da test am pc r . 
tli is routine should only he run on 1 resh i y-i ormat ted or blank drives. The 
syntax of INITL'Ik is summarizes at: 


INITDIR // 
INITDIR 
INITDIR d[ : ] 


<- — Print summary help message 
< — Execute in Interactive Mode 
< — Initialize Drive D: 


6.12.2 INITDIR Error Messages. 

Directory already initialized 

The selected disk is already prepared lor P2D0S stamps 


Illegal drive name 

The character entered was not in the range of "A" thru ’ P' . 

Not enough directory space on disk 

The directory on the selected disk is more than three-fourths 
full. Not enough space is available to support P2D0S file stamps. 

Di rectory read error 

An error was encounteiec in reading the disk directory. 
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Directory write error 

An error occurred while writing the initialized directory. ! 
will probably result in loss of file data. 

— > DateStamper ! ! 1TIME&.DAT File Found < — 

Proceed anyway (Y/[Nj) : 

The special DateStamper ! ! ! T 1 Mt .& . DAT file exists on the disk, 
other files are also on the disk, most of the DateStamper time and date infer 
mat ion will be lost. On freshly-formatted or empty disks, no DateStamper fii 
stamp data exists, so it is sale to answer with a Y and initialize the disk. 
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6.13 INSTAL 12 - Boot Track Support Utility 


JNSTAL12 - Install CPR. ZS1X4S. B./P Bios in a MOVxSYS "type' image 

from standard size (2k CCP, 3.5k DOS, 4.375k Bios) files 

INSTAL 12 is the latest modification to the ZSDOS INSTALOS utility distributed 
with ZSDOS 1.0 which automatically overlays your computer’s System Image file. 
such as MOVCPM.COM (CP/M) or MOVZSYS.COM (ZRDOS) program, or Absolute System 
Model file (e.g. . CPM64.COM) with ZSiXiS or ZDDOS to produce a new file con- 
taining ZSDOS/ZDDOS instead of your original Basic Disk Operating System. 
INSTAL12 also allows you to set the defaults of various ZSDOS parameters 
during the installation process (these parameters may also be changed later 
with t he ZSCONF K> prog ram ) . 

INSTAi.12 is designed to make the installation process as easy as possible. 
With JNSTAJ 12 you mat load fjies from all drives and user areas from AO: to 
P3 1 : . hrror detect ion is extensive, and Section 6.13.3 oi this manual ful Iy 
explains all INSTAL 12 error messages. finally, you may safely abort INSTAL -2 
at nearly al l points by pressing cc*ntiv!-<. . 

Before using INSTAL 12. ensure that any necessary files from your B/P Bio 
arm; /or ZSDOS Distribut ion Disk are present : 

u Microsoft . RLL formatted assembly of B/P Bios (MOYCPM = yj.s ) 

O' zsixOS./ki. tit replacing unc-rat trig System! 

o Z( '.14:33 . Ki- i . 2cPi:34 . Zki or oilier comn^ proc (if replacing CPI; ) 
o 1 NS! A: IJ.'od 

The following file from y- «•> r B/P bio:- Distribution Disk. OP/M or ZRIkjs System 
1 ) - s k mu st also be a c i. e s i b i e : 

o MOYxSVS.COM (B/P Bios'. MOVCPM.COM (OP/Mi . MOYZSV S . O Af ( Zldr.ts ) . 
or system Image tile for systems such as the Oneac ON! 

6.13.1 Using INSTAL12. 

To run 1NSTAL12, most users should simply enter 

INSTAL1 2 

at the Command Prompt. This tells INSTAI.12 that you are installing a system 
segment over a system Image relocation file, such as MOVxSYS.COM. MOVCPM.COM 
or M0VZSYS.COM. if you need to install a segment over an Absolute System 
Model file such as a CPM5P . COM . ZSYS TLM.MDL, or Oneac ON! file, you should 
enter 

INSTAL1 2 /A 

to run INST ! 2 i n Absolute mode . INSTAL !2 now displays its opening banne - 
and requests t he name oi a ‘ : it as: 
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System Image file to patch (Defaul t=MOVCPM. COM) : 
in Relocatable mode, or 

Absolute System Model (Defaul t=SYSTEM.MDL) : 


in Absolute mode. 

You need not enter all oi the information; INSTAL12 will fill in any miss in.? 
items with the default disk. user, or filename. If you simply hit RETURN. 
1NSTAL1 2 searches the current directory for the default System Image or Abso- 
lute System Model file (MOVxSYS.COM. MOVCPM.COM or SYSTEM. MUD. Here are some 

samp 1 e responses : 

System Image file to patch (Defaul t=M0VCPM. COM) : B3: 

(Selects M0VCPM.COM on drive "B" in user area 3) 

System Image file to patch (Defaul t=MOVCPM. COM) : 10:MOVYSYS 

(selects M0\ YSYS . COM on the current drive, user 10} 

System Image file to patch (Defaul t=M0VCPM. COM) : C:M0V18SYS.0LD 

(Selects MOV i SSl s . Or,! > on drive "( . current user area ) 

Once IN STAY 1 2 linds the requested file, it validates your ope r at ; ns system 
image. If the COP. bios or bios portions oi the System Image or Absolute 
S\ stem Mode i i.:ie are invalid. 1 NSTAu -J2 prims an error message and quits at 

this point. This may occur it an Absolute System Image was loaded but 1N.VJ A- 

LOS was invoked without the. /A suffix. If both methods ol calling 1NSTA1.12 
fail, first ensure that you; system image or generation program is operating 
proper i y . It you are sure that you have a working MOYxSYS, MOVCPM, MsAZSYS. 
or Absolute Moac- 1 rile that iNSTAl.12 cannot validate, you will need to contact 
your distributor who will initiate actions to correct your problem. 

11 all values in your operating system file match expected parameters, a 
summary of those values is displayed. if you specified a System Image file 
(e.g. . M0YxSYS.COM) . the display should be similar to: 

Addresses in system image (as seen under DDT) : 

CCP : 0980H Map @ 361 OH 

BDOS: 1180H Map @ 371 OH 

BIOS: 1F80H Map @ 38D0H 

The addresses shown will probably differ from these, but if both columns 
display values other than 0000H, INSTAL12 will correctly overlay the three 
system segment portions of the image with specified files. 

If you specified an Absolute System Model, the display will be similar to: 
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Addresses in system image (as seen under DDT) : 

CCP : BCOOH 
BDOS: C400H 
BIOS: D200H 

As above, the addresses will probably difler from those in the example, which 
are for a 54k system. 

If no error message appears. INSTAL12 has properly validated your file. Next, 
a menu of choices appears: 

1 - Replace CCP 

2 - Replace DOS 

3 - Replace BIOS 

4 - Save and Exit 
Enter Selection ("C Quits) : 

To instal 1 a new B/P Bios i mage from your assembly, select option 3. You will 
be asked to enter tne name of the file as: 

Name of BIOS file ( Defaul t=CBIOS.REL) : 

The default file type i kIT and the tile MUST be in Microsoft Ri.I. format . 
When a terminal mg varr mgv Return is entered, either the name you entered m 
the default will be located, i f f lunci. the size wi 1 1 be evaluated against the 
available space in the image file. often when adding a D/P bios <o an older 
system generation program, the set map portion of the program wi 1 j be relocat- 
ed. You w i : 1 be notified with :■ message signifying the distance in bytes th - t 
the map was rc located. Th i ••• is simply a diagnostic tool, and you should not 
be alarmed a* the message. Pol lowing the message "...overlaying ) Hr,...". 
INSTAL 12 will return t< the main menu for the next command . 

Replacement of the Command dioeessor with Z« 'PK.iJ.KL:. or ZO J l\d4 . Zki .i ’.cent ; • 
cal to fjjos replacement . exet pi tom no relocation or the bit map is poss i bo. 
The specified file w< i 1 either t it and overlay the original, or it will he too 
large and t he prog ran: will exit with an error message to that effect. 

for ZSDOS installation, enter a 2. You will be asked for the name of a husk 
Operating System file as: 

Name of DOS file (Defaul t=ZSDOS.ZRL) : _ 

The default file type at this point is ZR1. , but operating systems in Microsoft 
P.F.L format such as distribution versions of ZRDOS are also accepted. As 
above, you may respond with a full or partial file specification and 1 NS TALI 2 
will fill in any missing items with the default disk. user, or filename. 


Once the Disk Operating System file is found the following prompt appears: 


ZSDOS.ZRL Size OK. . .overlaying BDOS.. 
Examine/Change ZSDOS parameters ( [Y]/N )? : _ 
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At this point. INSTALL 2 allows vou to change the startup settings of all ZSIXXS 
options. If this is your initial installation of ZS1X5S. we recommend that you 
press N for "No" to bypass this step, and skip the following paragraph. 


If you enter any character other than N or n, the default option in brackets 
( [Y] for "Yes") is assumed, and 1NSTAL12 displays the current ZSfX)S defaults 
as : 


1 - PUBlic Files 

2 - Pub/Path Write Enable 

3 - Read-Only Vector 

4 - Fast Fixed Disk Log 

5 - Disk Change Warning 

6 - Path w/o System Attr 

7 - DOS Search Path 

8 - Wheel Byte Protect 

T - Time Routine (Clock) 

A - Stamp Last Access Time 
C - Stamp Create Time 
M - Stamp Modify Time 
G - Get Date/Time Stamp 
S - Set Date/Time Stamp 
Entry to Change ( "X" if Finished 


YES 

NO 

YES 

YES 

NO 

YES 

Disabled 

Disabled. 

Disabled 

Disabled 

Disabled 

Disabled 

Disabled 

Di sabled 


.Assumed ON 


These options are presented in the same- manner by ZSCONHG. and a re fully de- 
scribed in Section 4 , }(: of the XspuS j .() manua i . 


once you bvpas- t he configuration step or exit by pressing X. one of the 
following prompts appears depending on whether you are install. irg an I mag-, oi 
Ah so 1 u t e Mode i file: 


Name to save new system (Default=MOVZSDOS.COM) : 

o r 

Name to save new system (Def aul t=ZSSYS.MDL) : 

Again, you may respond with a full or part iai file specification and 1KMAL12 
1 I fill in any missing items with the default disk. user, or filename. If a 
file with the same name exists. INST, A). 12 prompts you for a new name . When 

J NSTALOS has a valid name, it creates your new system file and exits, display- 
ing one of the following messages: 

..Saving MOVZSDOS.COM - relocatable 

or 

..Saving ZSSYS.MDL - absolute 


6.13.2 INSTAL12 Error Messages. 

Occasionally ! NSTAL i 2 may issue error messages . Most errors result when r he 
fiies you specif led do not conform to INSTAi.i 2 ' expectations. otter the 
solution is to run INSTAL12 again, speci tying relocatable mode i ns; end oi 
absolute mode or vice-versa. Many TNSlAl.i 2 errors will a i so result from 
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damaged files. 7 f 7NSTALI2 gives errors in bet h absolute and relocatable 
modes, try re copying the source tile from masters, or re-assemble the source 
program and execute 1NSTAL 1 2 again. 

If all of the above fail, your system files may contain information which 
INSTAL12 cannot recognize. You may be able to attempt an alternate installa- 
tion with NZCOM or JetLDR for CPR and DOS segments, but you may need to con- 
tact the experts on Lade r a Z-.Node lor assistance with Bios-re 1 ated problems. 

The following is a summary of ail INSTA1 12 error messages, their meanings, and 
some pos sible r erred i e : . 

*** SORRY! ZSDOS will only run on Z80 type computers! 

ZSDOS and its utilities will on J y operate on processors which 
execute the Z80 instruction set such as. the Z80. NS(. -800 . Z180 or lll>(>4 1 80 . 
There is no t sx for this condition other than to run it on another system. 

*** Unable to open [f i lename. typj 

iNSTAi.l 2 cannot locate or open the system file you spec i i ied . 
i ] rst . ensure that the file is at the default or specified drive /user loca- 
tion. If you nave spec i i ied iTk 1 liie correct ly nut this error persist:.-., 
obtain a i re-sh copy of your system Tie and try aga ii . 

*** Can’t find CCP/BDOS/BIOS at standard locations !!! 

The operation system contained m your system tile is not a stan- 
dard U ' /'A svstem. It contains a ( fp wo i en is not exact i y 2 kilobytes ionr. a 
Bixih which is rwa exact ly kilobytes lone, or both. It this rm .'.sage ar— 
pears, first ensure that you r system f i le has not been damaged . ! f you still 
receive this. mess. or. . contact the author- on Lade ra 2 -Node or vour dis; ribu- 


++ Image Vector does not match Calculations ++ 

INSTT.i- found an internal error in the image file while itv-cT— . 
ina a MOVCPM-tvpe file. if you did not use the /A opt i on when runr.in? 5 N.N TA- 
LI 2. vou may be trying tc per f orm a relative installation on an ahso itu >. file. 
Trv runnirv- TNSTAi 12 again with the command INSTAL12 /A. 

*** Cannot find legal Relocation Bit Map 

] NSTAT. 1 2 was unable to locate a valid relocation bit map pattern 
in the MOVCPM-type bit when installing in Relocatable mode. Non-standard 
relocatable image Tiles are the general cause for this error . A workaround is 
to generate an Absolute Model with MOVCPM first, then use INSTAL12 in Absolute 
(/A) mode on the Absolute Model file. 

Can’t find [fi lename. typ] . . reenter (Y/[NjJ : 

The replacement file ( eCT , BDOS or BIOS) specified cannot be 
located. Ensure that the drive, user and tile name are correct. 

*** Error in .REL sizing [fi lename. typ] 

Err Code : nn 

Ar error occurred during the sizing operation of I NSTAL 1 2 on t rv; 
R1,T or ZRl file. The R1.L c r ZR1. must be in Microsoft relocatable format. 
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Named Common segments other than CCP . FtfXXS • and BIOS are not allowed, 
and code and data segments (if any) must not overlap. 

*** file too large to fit... 

The size of the relocatable CCP or HOGS is greater than the avail- 
able space in the image file (2 P-rtf bytes for the CCP, 3584 bytes for the 
BOOS). This error may result if the relocatable file is not in proper Micro- 
soft PPL format, or if a customized file is used. This error should never 
occu’ - with the distribution ZSDOS.ZRL file, which is exactly 3584 bytes (3.5k) 
1 one . 


*** Error opening : [f i lename.typ] 

INSTAJ.l 2 could not open the specified relocatable file. Ensure 
that you selected a valid Rid. file. 


*** Error reading : [fi lename.typ] 

INS'1AL12 detected an error when readme the specnied re local abb. 
file. Try recopv in.? tee tile. 

*** Error in .REL file : nn 

An erros was tour. ; in a relocatable input file wn : ;c tvmp’ : . t. 
replace the (. cp. hiX>5 o: him- p.. n iorp ot your operating xyster.. nn 

hexadecimal code which p ... nsr-isi in I oca? ins t A. cause o; th-. error. conia.: 
you: o i t r ibut o; , f vt r<e • A i p :x resdvir; ... error of '.his nature v. i t • 
the code in * A 1 r ... 


That file already t, .sts. Overwrite it (Y/[NJ)? 

The tile voi: to i d INS-lAi. ;2 to write to already exist:-: 
■r '■ '• •" \ he... ! N'ST.M. ; 2 -xi; erase the previous copy and create a 3 

with th:s n.ux. . i. nt: r N t scree 1 . .. nee name. 


yc 

i : 


*** No Directory Space for [f i lename. typj 

There u - not enough directory space tor the outrx* t i 
'■elected d:sr. Send the output tilt to a di i Ttrert drive by pree . 
i J enanic with a c r i ve spe- dio, > : change the disk in the cutout drive 


I 


*** Error writing file. Try again with another disk ( Y/ [N] )? : 

‘bis me -.sage usually results from a lack ot disk space 
drove you specified tor output . Change disks and enter Y to trv asain. 


Of- l lr . 
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6.14 IOPINIT - 10 Package Initialization Utility 

IOPIMT initializes an I Op Buffer defined in the Environment Descriptor to tir. 
standard Dummy IOE format and patches it into the Bios Jump Table. It serves 
the same basic function as the older ZCPR3 method of loading a SYS. 10P file, 
but was added as a stand-alone routine to do essentially the entire installa- 
tion of the package. In so doing, additional space was freed in the B/P Bios 
core code allowing other routines to be added which cannot be removed to 
external programs. 


6.14.1 Using IOPINIT 

This program should be included near the beginning, of the initial STARTUP 
script for any system in which an 101’ is defined. NOTE: This routine MUST be 
run before any programs which change the Warm Boot Jump at location 0! 

No arguments are expected when calling IOPINIT with ail values determined from 
the executing system Environment. The routine responds to the norma 1 doubic- 
s lash help request as with all support routines. 

6.14.2 IOPINIT Error Messages 

No IOP Buffer defined in Environment 

Self-Explanatory, it the lop bull er has been deliberately resin av- 
during configuration or assemhh. no harm wi I ! be caused by executing l. ••PIN El . 

No Z-System Environment Defined 

This message should A? VIM appear since a v 
.script or is REQUIRED in E/E Bios equipped systems. li i 
encase ; s i ncor: ect vs. , .. ■ s ; at ca \ t i ca . mo j i t a w 1 1 nin ■. ir. 
nsec; to validate the l.nv i ronmer. c . 

*** IOP Already Installed! *** 

Sc ! i'-txj > ! anatorv . No harm is done to the system, tills message 
s i Dip it' lor mi or mat mi . 


• id Environment Be- 
de V , one pcs. ‘ !' • 
Descriptor that are 
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6.15 LDSYS - System Image File Loader 

I.DSYS is the primary ut i i i ty to activate a System Image file preparer: by 
BPBLILD (see e.lj. It first validates the currently-running system, then 
loads the image file, places the component parts where they belong in the 
computer's memory, and executes the Bios Cold Boot routine of the newly-loaded 
system. Image files may be either banked or unbanked and need not be placed 
m the current 1 v- logged directory, since LDSYS can access files along the 
system path, or from Z3-style Path specifications. 


6.15.1 Using LDSYS 

This utility provides the only way to install a banked system in a B/P System, 
and a simple way to test non-banked systems before final conversion to boot- 
able systems to be loaded onto system tracks using INSTAL12 . MOVxSYS and. 
BPSYSGLN. LDSYS expects only a single parameter to be passed on the Command 
Line, that being the name of an Image file to load. If' no File Type is ex- 
plicitly entered, a type of . IMGis assumed. The location of the desired file 
may be explicitly stated in norma i ZCPK3 fashion with either Dl : or Dll.: 
prefixes. The over a i i syntax of LDSYS is therefore: 

LDSYS [du ; di r : ]name[ . typ] 

When loading, two summary screens are displayed, the firs: from LDSYS itself, 
arid lie second from the t'oid hoot routine in the loaded system after coni roi 
is transferred from I.DSYS to the- newly- loaded system. A sample displnv from a 
bankeci system during development when installed on a Micro.Mint SB-lSt; is: 


B/P Bios System Loader Vers 1.0 31 Aug 92 

Copyright (C) 1991 by H.F. Bower & C.W>Cotri11 


CCP starts at 
DOS starts at 
Banked Dos at 
BIOS starts at 
Banked Bios at 


CC80 

(0F80H 

Bytes) 

DC00 

( 0F00H 

Bytes) 

1080 

( 0500H 

Bytes) 

EBOO 

( 0880H 

Bytes) 

1580 

(1269H 

Bytes) 


...installing Banked System 

SB180 B/P 60.25k Bios Ver 0.6 26 Jan 92 (Banked) with: 

ZCPR3+ Env 
ZSDOS Clock 
Hard Disk Support 
Warm Boot from RAM 
RAM Disk (M: ) 

Ful 1 Error Messages 
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All messages in the above sample screen through the line "...installing ranker: 
System” are printed by LDSYS. Ail subsequent lines in the above screen are 
displayed from the newly-loaded Bios. During alteration, or modification of a 
new system, this subdivision in the display areas may be a clue to any diffi- 
culties encountered. The position of the cursor at the bottom of the sample 
screen is the point at which the new Bios, now in control, attempts to load 
the Startup file defined in the B/P Header. If none is found, additional 
initialization will not be performed, and you will see only the prompt for 
Drive A, User 0. 


6.15.2 LDSYS Error Messages 

*** No file specified ! *** 

LDSYS was called without a specifying file to load. You may re- 
invoke it directly with the ZCPR "(JO” command as: 

GO f i 1 ename 

or call it in the normal fashion specifying an imace file to load. 

Ambiguous File: fn[.ft] 

At least one question mark {or expanded asterisk ) was detected in 
the specified file to load. Re-execute with an unambiguous file name. 

Error Opening: fn[.ft] 

The specified image file could not be located. Common cause lor 
this are a mismatch in the file name, no file with the default tvpe of "IMA' 
or an inability to find the iiie alone the Dos Lain or in a Public directory. 
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6.16 MOVxSYS - Boot Track System Utility 

this routine is a program to generate a bootable system image lor the boot 
tracks of a floppy or Hard Disk. It is customized for each type ol hardware 
system using the B/P Rios. The generic name MOVxSYS translates to a specific 
name reflecting the standard name ID, examples of which are: 

MOVYSYS YASBEC 

MOVAMSYS Ampro Little Board 

M0V18SYS MicroMint SB-180 


6.16.1 Using MOVxSYS 

This program is patterned after the original MOVSYS . COM distributed with mo-. • 
Digital Research OP/M 2.2 systems, bat extensively updated to reflect the /d 
System standard Help, entry of a base address or system size j it kilobyte:., and 
additional checks needed to insure B/P standards. 

Two basic parameters may be passvd to this program as arguments on the command 
lire. The- firs l suc-t it'ie- t he system size in either the equivalent number oj 
kilobytes in an equivalent CP/M 2.2 -system, or as the base address of the 
Command processor. MooSiS parses the first element to determine if the value 
i s a Hexadec i mu 1 number ending in t he letter " H and assumes that t he value 
specifies a starting add re*' if so. Valid addresses mu'-t be greater than 
8000!] to insure that the resident port ion ol the operating system in the 
Common Memory area. If the argument is not a Hexadecimal addi c . it is 
assumed to be a number of j.j iobytes in the range of 39 to 03. These sizes ; re 
has oti on t he stand a rd‘ CP/M component elements of 2k byte* for the Command 
Proces-oi . 3 . 5 k byes for the Basic Disk Operating System, and at least i ,?k 
byte; fo-' t he re* idem bios port ion. Several check* are performed w j t h .. n 


MoVxSYS and t! 
i nva j id ! oca t i 

io ini to. 1 executin 
'..is and incorrectly 

g portion of the Rios 
sized data areas. 

(('old Root ) 

to detect 

The second par 

ameUT whicii may be 

specified on the comm 

and line is an 

opt i ona 1 

a * t e r i s k ( ■■ 

o' Eiit Name and 

Type alter the size 

spec i f i cat i on 

If an 

argument i s ]■• r 

•esent . one of two actions will be taken. 

The Asterisk 

i nst rue 1 s 


the program t= • relocate the system image to the specified size, and simply 
retain it in memory upon exit ting without saving the image to disk. Any of he ‘‘ 
characters will specify the name of a file under which name the image should 
be written to disk. if no second argument is given, the image will be written 
under a file name of SYSnnk.BIN where "nn" will be the number of kilobytes in 
the system size described above rounded down to the nearest even number. 

Placing a system image on the Root Tracks of a disk is done by BPSYSGEN (see 
6.6) which may be done by immediately following MOVxSYS (invoked with the 
asterisk argument i by BPSYSGEN using the ’’Image in Memory" selection, or by 
specifying a 1 i le output from MOVxSYS, and invoking BPSYSGEN with the name ol 
the resultant file. 

If you reconfigure the Pi os for your system with the goal ol modi Ivina t lie 
Boot System, you must assemble P/P bios in the Non-Bankeri Mode by setting tne 
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BANKED equate to NO. and sett in? the MOVCPM equate to VI. S in the DtJ : ' 
file (see 4.2). The rev-sec! Bios may then be added to MeVxSYS.TOM with 1N- 
S1 AT 1 2 (see t*. 13) to produce a customized boot System ret iect uv you r ta i lore ! 
needs. Refer to Chapter 3 for a more complete description of the Installation 
process . 

6.16.2 MOVxSYS Error Messages 
**** Start < 8000H ! ! ! 

A size value or GPK Starting address was specified which results 
in a base address less than SOuulJ. Since the lower 32k of memory (0..”FFHi) 
may he hanked, the CPR MUST be in the upper half of memory. Execute the 
program again with an adjusted size spec ifi cat ion. 

**** Create Error ! 

The prog ram could not create the speed lied Binary output file. 
Possible causes arc a full directory, 'write Protected diskette, or bad media 
or drive. 

**** Write Error. . .Exiting 

An error occurred while writ • n 
Possible cause • are a med i a or dj nt error 
space 7 or i he idle. 

**** Close Error ! 

An error occurred while attempt ir:~ to close the speci ire : hine.iy 
output file. This is usually due t o a med i a or drive error. 

**** Size must be in 39.. 63 !! 

MOVxSYS was invoked with an invalid size (number- of K; specif k 
tion. Execute the program ag- in with an adjusted size specification. 

**** Bad Syntax ! ! 

The program became con! used and could not properly decide whit', you 
wanted it to do . Review the built-in help by entering: 

MOVxSYS // 

and f o 1 1 ow t he s vn t ax ! isted. 


g the specified Binary output file, 
. or a disk with inadequate storage 
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6.17 PARK - Hard Drive Head Park Utility 

PARK is a simple B/P i s t i 1 ity routine that moves the Hard Drive heads on all 
drives to the designated landing zone (also called shipping or park zone) if 
defined for the type of Controller/Drive in your system. When all drives are 
parked, the utility executes a HALT instruction which requires a hardware- 
reset or power-off /power-on sequence to overcome. To avoid the possibility of 
Hard Drive damage by removing power from drives while the heads are positioned 
over data storage portions of hard drives. PARK should always be executed 
prior to turning your computer off. This recommendation is particularly 
important for drives which do not feature automatic hard parking, or where 
such hardware features have failed. 

6.17.1 Using PARK 

This utility is simpiy called with no arguments, and sequentially scans all 
three possible Hard i>r : ve units, executing the SCSI ' Stop Unit" command on 
each. When all three units have been processed , the processor disables inter- 
rupts and executes a HALT instruction to prevent the units from becoming re- 
activated by subsequent instructions. Normally, only cycling the power « : 
pressing the Reset bet ten or. t he computer will allow processing to result . 
Developing the habit o' executing HALT before turning you . computer or f nr. v 
rex.u i t m increased h T ; re a. vou »• her: ciives. and should become routine. 

1 h is u t i J i t v i - a s r . . in! v e : s ; oi ( f s 1 T N i 1 1 ( s e e e> . J 0 > vh i c it pu ; ji> j - ;■ 

: vi-..va 1 ■■Ji.ii s to Is a. : o !i and on de.ring normal operation. 


6.17.2 PARK Error Message ■; 

+++ Not B/P Btos ... aborting +++ 

Ai at tepspt « a made to execute BALK under a bios other than V,/\ . 
or modification. made to the Btos altered the locations or values needed to 
correct 1> ielent \ i y x he svs tern. 

+++ Can’t Park this type of Controller! +++ 

HARK was executed with a type of Controller or drive in the hi os 
that does not implement the "Stop Unit" SCSI function. 

**** SCSI Block Length Error ! 

The Bios does nor support the Extended commands necessary to pars 
the heads using the Stop l; SCSI function. This is most probably due to 
changes during an ed i t /assembly of the Bios which altered either the Command 
Descriptor Block size, or the Hard Drive function which returns the values. 
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6.18 SETCLOK - Real-Time Clock Set Utility 

This util it} - provides a means of setting a B/P Bios clock from a physical 
clock contained in the ZSDOS ''LOCKS . DAT library. It presents a similar inter- 
face to the Z SIXES 1 utility TESTCLOK from which it was derived. 


6.18.1 Using SETCLOK. 

SETCLOK is invoked by entering its name with an optional Clock Driver Number. 
For initial testing, or trying different clocks (always a dangerous procedur- 
e). simply enter the utility name as: 

SETCLOK 

You will be asked whether to extract clocks from a library. [ i you are using 
a custom clock, answer No. If you wish to use a clock from the prepared ZSDOT 
library, enter Yes which is the default setting if a Carriage Return in en- 
tered. You will also be asked for the iocat ion (Drive /User) of the clock fir.. 
or library. This prompt sequence may appear as: 

Extract Clock from Library ([Y]/N) : 

Location of CLOCKS.DAT [BO:] : 

Drive B. Use r <5 i 1 lust me" in the above sample prompt will probably di 1 i er i: 
you r system fvi th t he current drive and user always shown as the delate t loca- 
tion. j 1 the- file is o>, the current l>- logged drive and PL'B! ic. it vi i 1 also 
ho found without specifying unique User ares. If the default reliects the 
.location of the CLOCKS . DA < i.le. or a Iocat ion accessible via the PCD ' i c 
1 eature . simply enter a carriage return . otherwise enter the iocn ion o' 
CLOCKS.!' A':, fo . lowed by a color, and a carriage return. A list oj over 4 b 
available clocks will appear. Tc. select one of these clock drivers, enter t be 
numbej correspond i ng to the clock, and the program will do the rest . Var ious 
messages will be d i sp i aye d as the clock driver is loaded. 1 inked and executed . 
jf all goes well, tlie f i no. 1 message will be the Date and Time read from the 
clock followed by message that the B/P Bios Clock was Set Ok. 

Alternatively, a clock driver may be selected for automatic execution accord- 
ing to a specification on the command line. To use this mode, the CLOCKS . DsT 
file must either be in the currently-logged Drive and User, or on the current 
drive with the PUBlic Attribute bit set. the syntax for this method of set- 
ting the B,/1 J Bios clock is: 

SETCLOK nn 


where "nn" is a number corresponding to one of the clocks in the CLOCKS . DA k 
file. this, method of operation may be used to set the Bios clock within an 
alias script such, as STARTLT-.COM common 1 y used when the computer is first 
booted 
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6.18.2 SETCLOK Error Messages 

Some of the errors in the SL.'K L(>K utility are generated by the top- i eve i 
program. These errors consist ol : 

+++ This is only for Z80 type computers!!! 

This routine will only operate with Z80 or compatible processors 
since it is a B/P Bios utility which is also restricted to these types . 

— Error in locating Clock file 

This routine could not find the CLOCKS . DAT Library. Insure that 
the library either exists in the current iv- logged directory, can be found vis 
the PUBlic feature, or is available along the DOS Path. 

Other errors are generated in the process of extracting and validating tne 
driver selected from the CLOCKS . DAT library. Such errors consist of : 

— Error Opening : clockname 

The Selected Clock driver in the Library con j d not be opened. 
Th i -■ is most otter, due to corrupt ion of the CKX’KS.DAI file. Restore it iron; 
sour ZSix-'S backup disks and tr> again. 

— Error Reading : fn.ft 

An error oca r r/ \vh : 1 1 reading t re Clock code from the library. 
'Mia a !•,•■■ , s pro ■ t oi'tcn dir- to corruption of tne CLOCKS. DAI file. 

— Error in : clockname 

An error occurred In the logical re local able structure o •' tin 
selects.'! c ! oc 1 d' ive: . 

— Error initializing DAT file 

An tore: was encorin' ered in initializing the C'.'XKS.bAM I iora.rv. 

— Memory overflow in DAT file 

A memory allocation error occurred in the Clock routine which 
cau. sec the a 'located memory to be exceeded. This should not occur in an’. - of 
t hr library cl or:-: drivers, but may be experienced it the guide ! met are nut 
loll owed when developing a custom clock. 

Still other errors relate to the reading and linking of the selected do. k 
routine whether it is iron: the Clock Library, or loaded as a Standalone dr it - 
er. These errors include: 

+++ Can’t find : CLOCKS.DAT 

SETCLOK could not find the referenced Clock file. This error vai 
be seen if an attempt is made to use a standalone clock driver which could not 
be found in the current Drive/User, via the PUBlic attribute, or alone the I> s 
Path. 


+++ Error on file open 

An error occurred while 
h a * t h • f I J c w «- t < cor r e c i ly a 


t ryjng to 

sembied an 


per: a standalone clock 

try attain. 
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+++ Error sizing : fn.ft 

The selected clock file contained erroneous or invalid s.: 7 iny 
information. ]f this is reported from the CLOCKS . DA'J file, reload the file 
from .your ZSDOS backup disk and try again. If it is reported while loading a 
standalone clock, it is most often due to incorrect specifications of the 
CSEG/DSEG/Named Common areas within the Clock template. Insure that the clock 
specifications were followed, reassemble the driver and try again. 

+++ Link Error : nn in file : fn.ft 

An error occurred while linking the relocatable code from a clock 
driver. The "nn" reported is an indicator to the exact nature of the error. 
Consult the authors if you cannot resolve the error. 

The final two errors are indicators that errors occurred after the clock 
driver has been loaded, ! inked, and validated. If either of these occurs . 11 
is most often due to selection of an incorrect clock driver, problems with the 
hardware control i ins the selected clock, or alterations to the B/T Bios cone 
wh i ch a i t e red t he spe c i f i ed i nt 0 r i ace . 

— Clock Not Ticking — 

The selected clock driver could not detect an .active c.ey 
is most often the result of se : ec t i ns the incorrect driver, or sett it 
reet values when asked for specific addresses or va iues wnen act iv.-.ie; 

— Error Setting B/P Bios Clock ! ! 

'i H it Bios reported an e: ror wit > le attempt 1 n_* to set the 
clock. This is most olt-n called by errors when modifying the mociuK. 
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6.19 SHOWHD - Partition Display Utility 

SHOWHD is a utility which is furnished with the B/P bios package as an aid m 
converting existing systems to b/P Bios without losing data, particularly on 
Hard Drives. It is not specific to B/P Bios and should properly execute on 
any CP/M 2.2-compatible system. Its purpose is to display the current Hard 
Drive Partition settings so that you may configure a B/P Bios in either source 
code, or image form (with BPON'FG) to reflect the same partitioning data. 

6.19.1 Using SHOWHD 

This routine is a basic utility which is normally infrequently, so frills were 
not added. It expects no arguments and only operates in an interactive moot. 
To execute it. simply enter: 

SHOWHD 

You will be prompted to enter a drive let ter . When entered . you : i he 
presented with a cl i spJ ay listing the logical parameters for the drive, 
sample ot exc-cut ion ;s: 


| Show Hard Drive Partition Data - 
! 

2 Nov 91 | 

Enter Drive Letter 

[A..P] : C 


| Drive: C 

DPH Info 


BPCNFG Info 

Sectors/Track = 

64 

(same) 

Blk Shift Fctr = 

5 

4k/B1 ock 

Block Mask - 

31 


Extent Mask = 

1 


Disk Blocks- 1 = 

4995 

20000k Total (2500 Tracks) 

Max Di rs - 1 = 

1023 

1024 Dir Entries 

Alloc bytes = 

FFH, 00H 


Check Size = 

0 


Track Offset = 

3500 

( same ) 


6.19.2 SHOWHD Error Message 

Only one message may be displayed from the utility. It is: 

+++ Invalid Drive : d 

trie Drive Letter selected was not a valid drive within the Rio , 
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6.20 SPINUP - Hard Disk Motor Control Utility 

SPINUP is a generic B/P utility to directly control the heads and motors ot 
newer SCSI drives. It moves the heads on the specified hard drive unit to the 
designated shipping or park zone and may turn the drive motor off if called to 
Stop the unit and that feature exists in the drive. If called to Start the 
unit, the drive motor is turned on (if applicable) for the specified drive 
unit and the heads are positioned to Cylinder 0. This routine may be used as 
a power conservation feature where operation can be continued for periods of 
time from RAM or Floppy drives without need to access the hard drive unit. 
Attempts to access a unit which has been "spun down" with SPINUP will result 
in an error. This routine is essentially a generic version of PARK (see 6.1?) 
and is furnished in source code form to demonstrate methods of interfacing to 
Hard Drives from Application Programs. 


6.20.1 Using SPINUP 

This utility was vriilei for use primarily in battery-operated system:., where 
power conserva t. ion is desired. Generally, only the newer SCSI drives respond 
to the Stop/St art Unit commands by controlling the drive motors and posiii-r- 
ins the heads over' the designated Landing Zone". SPINUP is Command -I. in. 
driven and expects an argument consisting of a tali d Unit Number for tlr.. 
physics; Hard Drive un i t ( see 5.2.1. COM JG+ol ) . Valid Unit Numbers arc "O' . 

" ! ' and "2" . 

Stopping tb. uni' is indie. v: eri he preceding the- Unit Number with a m i nu s - g- 
a s : 

SPINUP -0 

which will cause t m t 0 to park the heads and remove power from “l.v d - i v . 
motor if possible. Starting the unit i indicated by sin. ply passing the end, 
Number as an are ament : 

SPINUP 0 

Whether starting or stopping a Hard Drive Unit. SPINUP monitors the unit 
status after issuing the command and reports the status of the drive when 
results of the operation are received. Results are returned as; the unit is 
Stopped. Started, or an error has occurred (see (>.20.2 below). 

Prior to using SPINUP to stop a hard drive, you must insure that accesses to 

any logical drive on that unit will not occur while the unit is stopped by 

either exchanging logical drives with BPSWAP (see 6.5) or altering the Command 

Processor and Dos Search Paths with the ZSDOS Utility ZPATH . For example, if 

your system includes a partition on the subject Hard Drive as Drive a:, you 
have logged onto a PAM Drive as M: and the unit is stopped, ZCPRT and ZSDOS 
may attempt to find a file on drive A: which will result in a Read Error . In 
this example, you may either swan drive A: with M: . insuring that M: is not in 
ei 1 her path- or set Doth path c to exclude di ive A. 
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6.20.2 SPINUP Error Messages 

+++ Not B/P Bios ... aborting +++ 

An attempt was made to execute SPINUP under a Bios other than B/P, 
or modifications made to the Bios altered the locations or values needed to 
correctly identify the system. 

+++ Can’t handle this Controller Type! +++ 

The Controller Type within the Bios cannot handle the "Stop/Sta i 
Un i t " SCS I Commands . 

**** SCSI Block Length Error ! 

The Bios does not support the Extended Commands necessary to turn 
the drive on and off using the 'Stop Unit" and "Start Unit" SCSI functions. 
This is most probably due to changes during an edit /assembly of the bios which 
a i tered either the Command descriptor Block size, or the Hard Drive function 
which returns the values. 

**** i nva i id unit # ! 

The spec i 1 1 eci tuvir number was not "0", " 1 " or "s'. only tit ret 
phvsital Hard Drive units are recognized in B/P Bios. 
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6.21 TDD - SmartWatch Support Utility 

TDD is a customized version of the ZSPOS utility* TU. With ZSDOS2 systems . . t 

used to display, set or update the B/P Bios clock. This latter capability 
only exists with the Dallas SmartWatch (DS-1216E) or JDR No-Slot -Clock in the 
Ampro Little Board. SB 180 or YASBEC. 

6.21.1 Using TDD. 

TDD obtains the system Time and Date with a DOS Function 98 and displays the 
information on your console. Your system Must have an installed clock driver 
to use this utility. If the clock driver supports a set function. TDD can set 
the Date and Time using DOS Function 99. When setting the clock. TDD will 
allow you to operate in either an Interactive or Command Line driven mode. 

TDD responds to the standard Help request described in Sect ion 1.7. You may 
obtain a brief usage description by entering: 

TDD // 

You may obtain the current Date and Time from t he system clock by simply 
entering the program name as: 

TDD 


If you are usirr: a Dal las • 2 1 (w.-base- 1 clock, you can set the B/V bios ciocT 
directly by entering: 

TDD U 

A continuous d iso lay may be obtained wnien will update every second unt i 1 any 
key is depressed by entering: 

TDD C 


The system clock may be s- t in the interactive mode by entering the p:;vr 
name- followed by the "S" parameter as: 

TDD S 


You will then be asked to enter the date. The prompt will display the format 
in which the date will be accepted It'S or European) as either: 

Enter today’s date (MM/DD/YY): - LS 

or 

Enter today’s date (DD.MM.YY): - European 

Date fields (month, day. and year) may be either one or two digits in eac ! : 
position. i ova I id entries such as an invalid da}' f or the entered month wi i ; 
cause the prompt to be re- displayed tor a new entry. 

When ;; valid date has as: entered . you will be prompted for the current ume. 
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The prompt will vary depend i ng on whether you are using a Rea! T i me Clock, c 
the Relative counter substitute for a clock. The two prompts are: 

Enter the time (HH:MM:SS): - Real Time Clock 
Enter the relative time (+XXXX): - Relative Counter 

Time is assumed to be in 24 hour format when a Real Time Clock is being used. 
Seconds may be omitted when setting the clock. When the relative clock is 
used, a '+' must prefix the count to which you wish to set the relative Coun- 
ter. Counts iron: +0 to +9499 are permitted. 

v.hen the time entry is ended with a carriage return, the date and time will 
not be automatically set. A message will prompt you to press any key. m 
this point, the next key depression (other than shift and control) will set 
the clock. This procedure allows you to accurately synchronize the time with 
one of the many accurate tins sources. 

Command Line sett me of the clock is .initiated by entering the program name 
followed by the elate and optional time. The date must be in the correct form: 
CCS or European.' lor the configured TDD . If an error is detected in a commend 
Line clock set. TDD switches to t he interactive mode and prompts for date and 
Tifne as described above. 


4.6.2 Configuring TD. 

TC can be con j gu red to p~c. cn!: th. . irm in c ither the US format of morn!:, 
day . ye r a-: Sep IS, 1988. or the European and military style a-: 18 Sep 
19SS. Likewise, t he set function accept s a Cs format of MM/bb/YN or T 
European l.'i.'.MC. Yi . The de~-.ult may be set with A! Hawley's ZCNrC ui i ! i ■ \ 
using data contained in the 1 Db.c'I C> file on the distribution disk. 


4.6.3 TD Error Messages. 

hrror me.- save- for 1 D are simple and are mostly self-explanatory. For c 
ty . however, t hey arc covered litre . 

SORRY! ZSDOS or ZDDOS is required to run this program! 

You tried to run this with someone else’s DOS. Use ZMX’S o: 
ZDlXiS. This error aborts to the. Command Processor. 

*** NO Clock Driver installed!!! 

You tried to read a clock which does not exist. install a cioc > 
with ST rUPZS'j and try again. This error aborts to the Command Processor. 

*** Clock does NOT Support SET!!! 

The clock driver on your computer will not permit you to set the 
titie with 11>". Tin s error aborts to the Command Processor. 
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*** Must have B/P Bios to use! ! ! 

This utility only functions under B/P Bios. if you are using B/P 
Bios and this message appears, it is most probably clue to edi t /reassembly of 
the Bios source which altered critical values in the data structures. 

*** Hardware Type Not Supported ! *** **** 

Since TDD is integrally tied to specified hardware platforms, it 
will only function if the running computer is one of the types for which the 
correct code has been implemented. This error should not appear unless the 
"U" or "S" comman is issued. 

++ Insufficient Memory! ++ 

The base of available memory has been reduced below that needed 

for the portion of TDD which is relocated to high memory. The most common 

cause of this is the acid i t i on of Resident System Intensions (RSXs) which cause 
the top of the TPA to be reported as below 8100H. 

*** Error in Data Input 

An invalid character or number was entered when tryinr to sen the 

date and time. This error wi i i cause the Interactive mode to be entered and 

issue a prompt to re-enter correct riate/t ime. 

*** Must be wheel to set clock! 

An attempt was mack n» set the clock w i i hout «'hci ! ac.ces- 
ZSf'ONr 1 G ( ZS] K'S 1 ) or 7. SCI <2 ( ZS1XJ.S2 i to .-.ct a vaiicl Write! byte, o' - d i sub : p 2 
(see b.2 2 for /Si tC2 or the ZSoOt 1 manuni tor Zs o\: it c. . I hi- ei or ;C> : - 
to tne i ommand Proccsso: . 

*** Must have Z180 Processor! ! ! 

*** Must have Z180 to Set No-Slot-Clock!!! 


**** Can’t find No-Slot-C'lock! 
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5.22 ZSCFG2 - ZSD0S2 


/.St K'.Z is a program to con f i pure various parameters of a ZSi ». b 2 opera! ins 
Svsrem. Jt is induced in this manual due to the dose interact ion of ai I 
parts of an operating system, particularly the Banked and Portable BIOS. 
ZS(’f’G2 operates in either an interactive (novice) or command line driven (ex- 
pert) mode for maximum flexibility and ease of use. If your computer is 
running ZCPP3. the Z3 Environment is automatically detected and ZSCFG2 wi i i 
use video attributes such as reverse video and cursor addressing to enhance 
the display. 

As in all of our support routines, a brief on-line help message is available 
by entering the name followed by two slashes as: 

ZSCFG2 // 

This configuration tooi automatical !v taiiors itself to the ZSLkjSj system . an. 
Pi messages, from Help to Interactive prompts wj 1 ! accurately reflect tin. 
opt i one and statu: t the running corn i curat ion of ZSIXjsj. 


6.22.1 ZSGF02 Interactive Use. 

To start ZN> >-G2 i r. the iru-rcr ns msec. simply enter the orog n nn ■ o : 

ZSCFG2 

If a xtn u' /r be.' env i recti,, ent locale 1. the screen is cleared. <• you v, : j 

st c c. screen n n: i n . s c ne>. de.: address..:- Iron; the environment . and a tabula: 
display oi thv cu: :can .-.■ct lings within the ope rat ing ZS-X).s2 system. Kc'.erse 
v '* • '*•. is u-'.b to enhanc-. i ho- display ji available. !• you are us ins a comput- 
er rd.ih is not epuinped v;ti. /■ | or cannot support direct cu-sor afdress- 

di.-' . t to inf* Trout ion Mesa } •‘• > K2 addresses) is simply scrolled up the screen, 

one line a i a t imv . The on 1 v content differences between the two display- is 

thro no data on the / r 'i'i:3 environment will be displayed. An example of a 
ZSi >• vS .2 cl 1 sp 1 C: v i •= ; 
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...Configuring ZSDOS Ver 2.0 


1 - Public Files 

2 - Pub/Path Write Enable 

3 - Read-Only Vector 

4 - Fast Fixed Disk Log 

5 - Disk Change Warning 

6 - Path w/o System Attr 

7 - DOS Search Path 

8 - Wheel Byte Protect 

T - Time Routine (Clock) 

A - Stamp Last Access Time 
C - Stamp Create Time 
M - Stamp Modify Time 


Z3 Environment at 

FEOOH 

ZCPR 

Path Address 

FDF4H 


Wheel Byte at 

FDFFH 

YES 



NO 



YES 



YES 



NO 



YES 



Enabled 

- Internal 


Enabl ed 

Addr = FDFFH 



F168H 
Di sabl ed 
EEB2H 
EEBCH 


Entry to Change ("X" to EXIT) 


The type of Operating system and vers i on number art first displnve; . fo! !ovtv 
by an\ ZCPR3 J ,nv i ronment inlormntion needed . It no environment is I oca ted . 
you trill see a message to that e- fleet . 3n such a case, certain opt ions v> i I 1 
be restricted as covered inter in cittai It ' descriptions. 

interactive ope rat 1 on cons i st s sin:r-! v of entering the number or letter in the 
left of e;._r line to select a function. If you select numbers between one and 
six . the opt j on is chanced from OFF to ON or vice versa, and the menu and 
status are again displayed. I f you select any ol the other items, you will be 
asked for more detailed informat ion. Section b.22.2 be low contains a detailed 
descr i pt :i on of a 1 1 opt i ons . 


0.22.2 ZSCFG2 Command Line (Lxpert Mode) Use. 

Command line entry iot Lxpert Mode) provides the ability to dynamically set 
ZSDOS options within STARTUP scripts, ZCPR Alias files. Submit files, or 
directly from the your console. This permits the operating system parameters 
to be tailored to specific applications, and restored upon completion. For 
example, a submit or alias command might feature the following sequence: 

Disable/ Enable ZSDOS features and set addresses 

. . .Process application programs 

Restore ZSDOS features and addresses and return 

Tailoring of ZSDOS in this sequence would be via a call to ZSCFG with argu- 
ments passed on the command line within the script. In this fashion, you do 
not have to constantly attend the computer to change DOS parameters. 

Settings are passed to ZSCFG as groups of characters separated by one or more 
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tabs, spaces or commas. Each group of characters begins with a Command char- 
acter which identifies the setting to be changed. In the case of the items 
related to time and date, a two-character sequence is used. A "+" sign iden- 
tifies the Command as a Clock, or Time Stamp-related function, and the follow- 
ing Command character tells which parameter of the six is to be changed. 
Command Identifiers for ZSDOS are: 

P - Public File Support 
W - Public/Path Write Enable 
R - Read-Only Drive Sustain 
F - Fast Hard Disk Re log 
! - Disk Change Warning 

S - Path without SY'Stem Attribute 
> - ZSDOS Search Path 

* - Wheel Byte Write Protect 

C - Clock Routine Address 
+A - Stamp Access Time 
+C - Stamp Create Time 
+M - Stamp Mod i t y lime 

Opt ions which are simply On/Off toggles require no arguments. You enable the.:, 
merely by entering the Command jetenti fieri s ) . To disable such options, you 
simply append a minu sign to the end of the Identifier, for examp i e . 

command line entry to activate the Fast Relog capability for hard disks, tun. 
PPblic bit capability on. ano disable thv Disk Change warning would be: 

ZSCFG2 F , ! — 

Cert a i r. option- reou re adc i t jona 1 parameters which are bandied be a seconds sy 
prompt in tht interact ive mode . Since no prompt can ire issued in the Command 
lone entry mode . tin aoaed pa rate-- tors are passed by appending them to the 
Cominsns Idem i fit-. . Ar example to set the Wheel bvie Write Protect to be the 
sanie as the /cpk.i Wneei H\ t c . Act ivate the Internal path and set me flock 
add res- t .•> t he s ion lard b/-‘ loos Clock Vector is: 


ZSCFG2 *Z , >1 ,CB 


Yitu must remembe r that NO spaced or other delimiters (spaces, tab; and comma* • 
are permitted between the command Identifier and added arguments. An 'In- 
valid” error will generally be the result if you forget. When entering ad- 
dresses or numbers as arguments, they are always in Hexadecimal (base 161 witn 
optional leading zeros. The algorithm used to interpret the number entered 
only retains up to four digits. Therefore, if you enter the sequence 
"00d6C92K)45" . it would be interpreted as 1045H. 


The following section describes each option and what alternatives are avail- 
able to optimize it for your system. 


6.22.3 ZSCK i2 Option Descriptions. 

" b- j two i oo i s wn i l h permit tailoring of a ZSDOS2 system to v-.n 1 r specif 
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needs. INSTAL12 and ZSOFG. both present the same interactive display . 1 hi s 

section, therefore, is applicable to installation as well as "on tne fly 
customization with ZSCFG2. Each opt ion will a iso include specific arguments 
for Command Line entry of the option, options will be covered in their order 
of appearance in the INSJAL12 and ZSCFG2 interactive menus. 

6.22.3.1 Public files. 

Interactive Prompt : 1 - Public Files 
( toggle ) 

Command Line Character: P 
Finable - P 
Disable - D- 

This flag controls recognition of the Plu*Perfect PURlic attribute bit ( Hi t 
of the second letter in the file name). When set to YLs or activated, ary 
file having this bit set will be accessible from any user area on the d : • ; . 
This means that a search for t he file will locate it on the first try. regard- 
less of which User Area is currently selected (sec 2.9.4. Public Access ; . .1 f 

set to NO. the file v : i ! i>. private and can or. - ! v be found if the user area, 
matches that of in., file. The default setting for this option is Y: s. to 
recognize iVnC : c I i i c s . 

6.22.3.2 PubLic/Puth Vrite Enable. 

! nt cract i ve : 2 - Pub/Path Write Enable 

i toggle ? 

( lommand Line Character: V 
Friable - W 
Disable - W- 

tYhen st t to YES or activated in command Joint- mode. ZSLVSi wi"! perm v. r : t e 
ope rat :ons to Publ'c files, ana i n the case or ZS: *0S2 . files located a : ong the 
Path. When set To V » or disabled, attempts to write to the file v. I : rest' : t 
in a "Read-Only' error. The default setting lor this option is No. 


6.22.3.3 Read-Only Vector Sustain. 

Interactive Prompt : 3 - Read-Only Vector 

( togg 1 e ) 

Command Line Character: R 
Enab 1 c - R 
Disable - R- 

When set to Yl-S or activated, the normal Write Protect vector set by ZSDOS2 
function call 26 will not be cleared on a warm boot as wi th CP/M and ZRDOS. 
] f set to no or disabled, the write Protect vector will function as in CP/*-' 
and ZRlK/s. The default setting for this option is Vi • . 
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6. 22.3.4 Fast fixed Disk Re 1 0 . 2 . 

Interactive Prompt : 4 - Last fixed Disk Log 
( to 22 i c } 

Command Line Character: I*' 

Lnab 1 e - F 
Disable - F- 

When set to YES or enabled, the allocation bit map for a fixed drive (one in 
which the WACD buffer is zero) will not be rebuilt after the initial drive 
logon. This results in much faster operation for systems with Hard Disks and 
RAM disks. if set to NO or disabled, the allocation map will be rebuilt each 
time fixed disk drives are initially selected after a warm boot . The default 
se 1 1 i ng tor this opt i on i s YES . 


6.22.3.5 Disk Change Warning. 

interact tvc Prompt : 5 - Disk Change Warning 
( togg : e ) 

Command Line Character: ! 

Enable - ! 

Di salt it - !- 

When set to YJ s or enabled, a warning vi i i be printed whenever ZsbOS 2 de 1 r ; : ■ 
that a disk m r-. removable-media drive (nor run I iy t loppy disk drives.) has la-.:, 
change.: if you p-rcss any lev othe; tire: tomrol-t . LSI .OS 2 will auconr t .... I 

i or: :e, the net’. d:sl and cone : nc; . 1: set to N't > or disabled, no warning w | 1 : 

be given, one 1 In di 1 ef ;! he nu t om..t 1 c a ! i y logged, airs the opera' ion ; a 
is sorter v- ; ; I continue. It.e oefault setting for this option is No. for no 


6 . 22 . 3 . 6 Path Without System Attribute. 

Interact ive Prompt : t> - Path w/o System Attr 

; 1 02 2 1 e 1 

Command Line Character: S 
Lnab i c - S 
Disable - S- 

W’hen set to YES or enabled. Public files on drives along the Path will ;>•„ 
1 ound without the- System Attribute being set (see 2.9.2, Path Directory Accco. 
mode). It this option is set to NO or disabled, Public files on drives ad- 
dressed along the Path will not be found unless the System Attribute Bit (bit 
of the second character in the f i I e type) is set (see 2.9.3. Path file Access 
mode ) . The default setting for this option is NO or Disabled, requiring the 
Public bit Set on accessible files. 
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6.22.3.7 DOS Search Path. 

Interactive Prompt : 7 - [X)S Search Path 

Options - (DiisahJe. ( S ) et addr. (I Interna] 

( Z ) CPR3 (only if running ZOPR3 ) 

Command Line Character: > 

Enable - >addr, >1 

>Z (only if running ZCPR3 ) 

Disable - >- 

When this option is selected from the Interactive mode, you will he prompted 
for one of the three options. Contrary to the earlier ZSDOS 1 configuration, a 
ZCPR3 style Environment Descriptor is required, so the following prompt will 
a 1 ways be d i spl ayed : 

DOS Path [(D)isable, (S)et, (I)nternal, (Z)CPR3] : 

Operating ZSCI-G2 in the Command Line mode permits you to select the same op- 
tions directory from the command line as summarized above. No add i 1 1 on a 1 
characters are required for Disable. Internal or ZCPR3 path selection. if you 
choose the ( S let opt ion. you wi 1 : !u. prompted lor & Hexadecima ! ad-ires s with: 

Enter PATH Address : 


If you Disable 

the DOS 

Path option /isbos.: 

f UP . 

; t ; on- 

just 

as i i- /V 2.2 and 

ZRjv'is 

foj file 

- earcht . c . . 

Rec uc s t - for f - it" 

wi i 

i ■ a c vi 

e s ■- or 

1 y the current ly 

1 ogge 

. ri i sj- f.rsr 

user. mo--.. 

i i 4 i on 1 y yv i p-. j-uf 

, 1 I- 

Cf'iTV.b 

i ! i t y , 

i f act 1 v, . n i s 

res 1 .; ! 

t s j n t he 

T fio ; 1 ! U;' 

rt--tjU i i t-pier: to insta 

i i ; 

it ill t 

nr--. c -uc: 

:h as comp i it-rs . 

v.ord 

proves - - ■. r 

i ! 1- • 

has* management syst 

ems 

t o t c 

i 1 t hc-i: 

; ! )L :'C I * > iii ■ i ' 

f i nd 

tlveij over 

l cl " ‘ S . 






i rope 

! use of :. 

!k r>0S r’-i 

T It ov e T COiilv S t ht 1 III 

: tat 

j on i ’ 

’. 1 inciC 

"u; yrop rain o\ e: - 


lays and ot ncr ■ ; -. hy siivri}. - o it .in: the frig Patli to the ogive ana uses arts 
where the relevant p-. erlay- ana oth- 1 idles are stored. The- Path rap be a. • 
in three tops. 

The first way is to assign a fixed address using the is.-et option 1 rcm. Ur. 
Interact ive Mode . or by appending the address to the Command Character in the 
Command Line mode . You will be responsible for insuring that any path at that 
address conforms to proper ZCPR3 path definitions. 

The second way to set a I> >S Path is to use- the three element Internal path h\ 
selecting the { i Internal option i rom the Interactive Mode, or adding an "I" 
after the Command character .in the Command Line mode . As distributed, ZSDOS 
contains a single path entry of ’ AO: " to direct path searches to User Area 0 
on Drive A. An alternative way to activate the Internal Path is with the 
ZPATH.COM utility made available with ZSDOS 1 . ZPATH will enable you to change 
the default path, and define up to three drive/user search elements. 

fhc final met ho of setting a IXd- path is only available if you art- opera- in; 
a Z-. pr<3 system. it is chosen b; selecting the ( Z )CPk3 option i • om the : n: e: - 
act 've Moo.:-, co foi loving t he Command Character with a ’Z in the oomman ; ire 
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mode. This Path mode will probably see little use. but is made available for 
systems which need more than three elements in a path. The principal clisao- 
vanta.ee of v: . ng the ZCPR3 path is that requests from the command promr t ( e . g . 
A0> ) may result in n-squared searches where n is the number of elements in the 
path. The reason is that ZCPR3 will select the first path element, and ZSDOs 
will sequentially search along the entire path if the file is not found, 
returning to 2CPR3 with a 'file not found" error. ZCPR3 will then select the 
second element with ZSDOS again searching along the entire file. This situa- 
tion does not occur once an application program is started, since the Z(.T’R3 
Command Processor is no longer active. 

The default setting for the DOS Path is "Internal''. 


6.22.3.8 Wheel Pvt e Write Protect. 

Interactive Prompt : 8 - Wheel Byte Protect 
Options - ( ft ji sab l e . (S)et near (ZICPR3 

Command Line character: * 
hnabit - *addr 
* 7 . 

|i i sab j c - *- 

Unen you select t f: i r onr io:i iron: the Interact i ve mode- of ZSC'c v. \>. ; ; : 
presented with an additional lines containing available choices a : 

Wheel [ ( D) i sable , (S)et, (Z)CPR3] : 

.selecting t he (Pi opt rm Pv e: '.erinr a or disabling the ‘die- .■ I pvt e 

'■ tl: tin :1 - paramet: • string in the ; 'or.na.nd I ine mode will cause /SPr f ;a 
assuie i not tlu: ''sec! nvte is always ON giving the user lull pr i I t'-’e : s 

lilt cont ro i r i u- - . Renan-.-.; > and fra sure i . entering an d c d for i 8 ) e i from 
t tie Interne’ iv rtocic will aliov. you ro enter a Hexadecimal address tor r v.hce i 
Byte . 1 1 * r- you respoio i h i i i ty to insure that the byte is protec to: ro- 

necessary f rc-tr. liniment ional alteration. Setting a Whee I Byte add rfs. \ from 
live ("oti-mand line sjmpiv requires appending a Hexadecimal address a*te; the 
Wheel Command character. filtering a "Z" 1 rom the Interactive mode , oi a 
parameter string m t he Command Line mode will set the address to the address 
de lined 1 o i the Wheel byte in the ZCPRj-compat ibie P/P environment. '! he 
defauit for this opt ion is Of f or Disabled to assume that the user has f u ‘ i 
pr iv j I cues . 
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6.22.3.9 Time Routine (Clock Driver). 

Interactive Prompt : T - Time Routine (Clock) 
Opt ions - (D!i sab 1 e . ( S ) e t aciar 
Command Line Character: C 
Enable - C addr 
Disable - C- 


This option allows the user to enter the address of a clock driver routine 
conforming to ZSDOS standards, or disable an existing clock routine. When you 
enter a "T" at the prompt in the Interactive mode, the following appears: 

Time (Clock) Routine [(D)i sable, (S)et, (B)ios+4EH] : 

Entering a "If in the Interactive mode or the Command Line sequence wi i i 
disable any existing clock. The primary effect of this is to cause an error 
return to DOS function calls 104 and 105 as well as disabling Date/Time Stamp- 
ing functions. If you enter an ' s at this point in the interactive mode, you 
will be further prompted for a Hexadecimal address of a c 1 ock driver. The 
same effect of set t ins a does Driver address is achieved in the Command Line 
mode by entering the Command character fol lowed by a valid Hexadecimal 
address beginning with a Number . Selecting B" . or entering "CM ' as a command 
line argument, will Set the Dos clock Driver address to the base of H/P b»o" 
offset by 4htf winch correspond:- to the Jump table entry for the B/V ZSbur-- 
compatible clock driver. Do NOT enter unknown values since unpredictable 
results can occur ! 


6.22.3.10 Stamp East Accessed lime. 

Interact ive Prompt : A - Stamp Last Access l ine:. 

Opt ions - ID) i sable. ( Finable 
Command Line Character: +A 
Ln a Lie - +A 
Disable - +A- 


This option is only available with Dates tamper type of Date/ Time S* amps . Er 
P21XDS. the function is not defined and is ignored within ZSDOS 2 . As stated in 
Section 3. 4. 4. 2. Unless you have a definite need to retain a record o* the 
last time files are accessed, we recommend that _vou disable this option to 
reduce unnecessary overhead. To Select the Last Access lime option, enter an 
"A" at the Interactive main prompt. This will display the following prompt : 

Stamp Last Access Time Routine [(D)isable, (E)nable] : 

If you enter a "If at this point in the Interactive mode or disable the func- 
tion with the sequence "+A-" in the Command Line mode, no times will be en- 
tered in the "Last Accessed" field in the DateStamper tiic. This option may 
he re-enabieci by seiect mg the ' L" option m the Interactive mode from this 
secondary prompt . or the sequence +.'■ from the Command Line most . 
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6.22.3.11 Stamp Create Time. 

Interactive Prompt : 0 - Stamp Create Time 
Command Line Character: +C 
Enable - +C addr 
Disable - +C- 


Entrv of a "C" from the main menu in the interactive mode wi j ] allow you to 
enable or disable the Create time stamping feature. A secondary prompt will 
be displayed as: 

Stamp Create Time Routine [(D)isable, (E)nable] : 

To disable the Create time, enter a T 'D” from the secondary prompt, or the 
sequence in the command Line mode. To enable stamping of create Times, 
enter an "if from the secondary prompt from the Interactive mode , or by enter- 
ing the Argument Sequence ' from the Command Line mode. 


p.22.3. i 2 Stamp Mod i fy T i or; . 

Interact iv*. Prompt : 0 - Stamp Mod i t y l ime 
Option- - (l)i isabie. (E)nahie 
• omnia, k! Line Character: +M 
i n i hie - +M 
If -fee - +M- 

Ihe- t i me O’ last Mot : ! it a” ion o t a file is probab i v the most va i uable of the 
times offered in a zs!.*)S yuew A-- such, you wi 1 1 probab ! y never have a n.eri 
to disable this leanne. Shou i d the need arise, however, enter an VC at me 
Interactive mum prompt . Vr ... w , ] i then be presented with: 

Stamp Modify Time Routine [(D)isable, (E)nablej : 

f you ener a at this point in the Interactive mode or disable- the 1 un-.- 
t tor with the sequence +M- in the Command Line mode, no times will be store a 
in the Mo. fy i ie Id ot any active Time Stamp activity. 

This opt ion may be re-e.nabien by selecting the "I option in the Interactive 
mode from this secondary prompt , or the sequence "+M from the Command Lin*- 
mod e . 
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6.22.4 ZSCKJ2 hrror Messages. 

Only two error messages exist in Z5CTG2. For the most oar: . any error - you see 
will deal with invalid parameters or entry mistakes. The two error messages 
are: 

— Invalid — 

An invalid address or character was entered in a parameter. 

*** ERROR: DOS is not ZSD0S2 ! 

An attempt was made to run ZSCFG2 on an Operating system which was 
not ZSD0S2. This program cannot function under any other operating system. 
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6.23 ZXD - File Lister Utiiity for ZSDOS2 

ZXD Version I .60 is a modification of an earlier version released wi 7 h our 
ZSDOS 1 package. it is the ZSix)s Extended Directory listing program derived 
from the ZCPR3 too] XL ill written by Richard Conn and now modified to proper- 
ly return disk sizing information from a banked ZSDOS 2 Operating System. 
Many additional capabilities were added over the original XI) 111. not the 
least of which is the ability to display time stamps for each file in a varie- 
ty of formats. ZXD can display file Dates and times from DateStamper . P2D0S. 
and Plu*Perfect Systems' DosDisk stamp methods. In ZCPR3 systems, the Vheci 
byte used to disable some functions as a security precaution .in remote 
access svstems. 


6.23.1 Usinq ZXD. 

ZXD is act ivatert l- entering its name at the command prompt . and mav be fol- 
lowed by optional drive and user specifications to obtain the directory of 
another drive o- user area. It mat' also be followed by various parameters 
which alter the format and/or content ol the display. ]f options are 1 i sted 
without be me preceded with a Hie specification (drive, user, file name • 
then tneg must he preceded oy tilt standard opt i on character, a siasn. A heir 
me s save may be obt a 1 ned in t he standard manner by entering: 

ZXD // 

ZXD accepts di rect ions in a naun a ! form popularized with the /<>■;, sei ios of 
( ommand Processor reri acemerv s . I sine tilt convent ions described in Section 
1.2. the syntax is summarized by; 

ZXD [dir:J[afn] [/] [options] 

t I 7>J * is ca J i eu w i t h no arguments, a a i splat of only those filer satisfying 
bn i i t-i n default conditions wi i ! be displayed. Norma i ) y these defaults st Sect 
Cl ! % non-svstem file:- in the current drive and user. The default select ions 
may be mod if i ed by opt ion parameters detailed below. 1 i opt ion parameters art 
desired without' drive, user or file specifications, then the options must be 
prefixed with a slash. '1 he slash is optional if any redirect ion or i i : e 
specifications are entered. 


6.23.2 ZXD Options. 

Option parameters, consisting of one or two characters, allow you to obt c . r. 
selected information from files on a disk, or to tailor the display to your 
particular needs. Each of these options is also reflected as a permanent de- 
fault . After deciding which parameters you use most by using the command line 
options, we recommend configuring ZXD to reflect those parameters as default-. 
The result- wi i j be the requirement to enter fewer keystrokes, and consequent- 
ly i aster operation when a directory scan is required. 
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The option characters are described in alphabetical order in the ioi lowine 
sect ions . 


6.23.2.1 Select Files by Attribute. 

In order to avoid clutter ine a directory display with unwanted file names. ZXD 
features a flag which controls addition of those tiles marked with the SYStem 
Attribute Bit. The A Option controls this feature. It requires a second 
character of S. N. or A. Control offered by these characters is: 

S - Include Only Files marked with the SYStem Attribute 
N - Include Only Files Not marked with the SYStem Attribute 
{this is t he cie 1 au ! t cond i t i on ) 

A - Inc lude A.I i F 1 les 

Since listing of all Non-SYStem files is the default condition, you w I ! 
probably not use the N option very often. The A option, on tne other hand, 
offers a simple way of viewing Ail files within the current directory, includ- 
ing SYStem files which are noimalJy invisible due to the Attribute bit. 

In a ZCPRA system where Wheel access has not been granted (Wheel byte is Off), 
this opt i on is forced to Non-SYStem ii les on I v and the A option character is 
not permitted. 


6.23.2.2 Date Display Format. 

The Date" f or a ZXD display may be displayed in either IS form of MM/PD/Yi or 
European form of bb.MM.Yi . You may override the default form with the D 
option. Here is an example ci the two types of date displays: 


OS form: 

ZXD Ver 1.66 3 Apr 1993 15:43:17 

Filename. Typ Size Modified Filename. Typ Size Modified 


INITDIR .COM 4k 07:01-09/17/88 ZPATH .COM 4k 07:50-09/17/88 

ZXD .COM 8k 08:01-09/17/88 

C2 : -- 3 Files Using 16K (324K Free) 
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European Form: 


ZXD Ver 1 .66 
Filename.Typ 

3 Apr 1993 15:43:11 

Size Modified Filename.Typ 

Size 

Modified 

INITDIR .COM 
ZXD .COM 

4k 07:01-17.09.88 ZPATH .COM 

8k 08:01-17.09.88 

4k 

07:50-17.09.88 


C2 : — 3 Files Using 16K (324K Free) 


6.23.2.3 Disable Date (NoDate) Display. 

While the display of date and time information is the default mode of ZXu . 
this may be disabled with the N option to display more file names on a screen . 

6.23.2.4 Output Control Option. 

'The 0 opt i on controls /XD's printer or screen output, and requires, a stwo:; : 
character which adds add i t i ona i control to output formats. 'I he second cnrni ■- 
ters recorn i zed are: 

F - Sene a Form Tee’ ch vac ter at the end of the list 
H - Torek- iior I zonta i /V ert : ca i display oi sorted lest .in:: 


6.23.2.5 Output to Printer. 

Option P con: to; output t .:> tin printer. When this; option i: :: ;vv'- ' n- 

S' Vi” tec; b j recton limits/ . sent to both the console screen and tnc printer. 
Tn i notion is oi cabled and not available in a ZCPl’3 system where W'h-.-e I sw- 
hat not been granted iV-ivel byte is 01 i ) . 


6.23.2.6 Sort by Name or '• ype. 

The deTault s,.o. t conditior, for ZXD is to first son by File Name . the 
Tyne within mat chine Name . Option S reverses the sequence. 


6.23.2.7 Primary DateStamp. 


ittempt to 1 ind one of 


ZXD t eatures an algorithm which will 
Date/1 ime Stamps lor each file. The default conditions tel 
attempt to locate Date stamper type of Stamps, if that fails, a 
for Dosbisk stamps from MS/Pt 
stamps. The T option causes 


s t? \ 0 r s i ype / O: 
ZXD t c firs 
search i -• mad' 
DOS disks, and finally to check for I'ZIOS ty:x 
the DateStamper checks to be bypassed, t herein 


spec 


; n ■: 


response if DateStamper type stamping is never used. 
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6.23.2.8 All User Areas. 

The distribution version ol ZXD will only search a single User area, either 
the currently logger) or the explicitly stated area, tor files. The U option 
will locate files in all user areas on the disk. Combining the U with the AA 
options will list all tiles in all user areas, both system and non-system, on 
a disk. This option is disabled and not available in a ZCPR3 system where 
Wheel access has not been granted (Wheel byte is Off). 


6.23.2.9 Wide Display. 

ZXD only displays the ''Last Modified" Date/Time Stamp. This may be reversed 
by appending the W option to the Command Line, which generates a Wide of all 
available Stamps. Onh" batestamper has provisions for ail three stamp catego- 
ries: P2P0S contains only Created and Modified stamps, while the single MS/]‘< - 
DOS stamp accessed through bosbisk best corresponds to 'Modified . A d; stony 
created with this option i s : 


Fi lename 

• Typ 

Si ze 

Created 

Last Access 

Modi tied 

BUI 6 

.COm 

8k 

17:26-06/12/88 

08:42-08/21/88 

17:26-06/12/88 

COPY 

.COM 

8k 

15:06-09/17/88 


15:06-09/17/88 

ZPATH 

.COM 

4k 

07:50-09/17/88 

15:02-09/17/88 

07:50-09/17/88 

ZXD 

.COM 

8k 

08:00-09/17/88 


08:01-09/17/88 


6.23.3 Customizing ZXD. 


The 
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7.0 ZSDOS Version 2. 

Version 2 o; ZSDOS is current Iv in a developmental 
t*d w j tit this package is preliminary and should not 
Be sure you back up any tiles which you don’t mind 
us know in as much detail as possible any problems 

In addition to the ZSDOS Version call (Function 4S) returning 20h signifying 
ZSDOS 2 , three new Operating System functions have been added. They are: 


phase. The version provin- 
ce considered a final work, 
sacrificing, and please iet 
you experience. 



Function 46 


Return Disk Free Space j; 

V, 

r= 

ji 

-- “■ " 

Enter: C = 46 (function. #) 

• - ■ ' " - ‘ - • ' jj 

Exit: A = 0 if Ok, <>0 if Error' j| 

I 

II 

E = Drive 

it i A=0 . ,P=1 5 ) 

Disk Free Soace m kilobytes ji 

is placed in DMA-f-0 ( LSB ) thru ji 
DMA+3 (MSB). ji 

(L 


i; ... J| 

: <; 

1 unct i on n tu rns 

D;sk tree Space 

from fully-banked systems where the 

f e 

rs are not direc 

l 1 V aC C V $ S i b 1 V' by 

applications program: . it MUST be- t 

re 

! i ah !y determ inc 

Iren -pace since 

thet’. ;s no way lor programs to a sc 


which System ]>.■: 

Hr i : f ii"’'"... 1 1. c. 

one; contains me Ai location Fit \ 

r n 

o.- t reasorah iy- - 

: • y • : en . on i 

v the iower two or three bytes w : i : 



. ■. as: t»> accommodate a maximally-sized xyster. 

ji 

>r uhc i " on 49 

Ug * i t 

*n Environment Descriptor Address 

i: 

tntc- : C - A'j ( ~ 

u* r . 1 1 cv'‘. runoe r ) 

i Exit: HL = Address of Env Dess, i 

; 

l C- 

T ’ f- + „ ,. M 

t p -.,rt -i c c , V 

ZVBR 3.4 "type" Lnvi ronmen: Descrir 

ede 

v. J ;• > j •>/]•' ]s i re :oy 

sieii:. . Rather than rely on the Command iTocesst r in sc 

O T 

n: id \ adore- s 

irus application 

programs upon execution, this fund 

v b 

e used to reli a:’ 

. v acquire the id 

c address at any time. 

i! 

i* 

IL 

Function 152 


~ - 1 1 

Parse File Name j 

1! 

IS 

Enter: C = 152 

p ; 

(function number ill Exit: A = Number of “?" in fn . f t j 

i! 

DE = Ron- 

ter to tiest FCB 

DE = points to delimits: - | 

i: 

ii 

DMA — > start 

of parse string 

FCB+15 will be 0 if parse Ok. ; 
i OFFFI if errors occurred. | 

t 

... 

. . - 

i! . J 


’! h i s junction may be us-_-d t. replace ZJi. IB library routines in 
mannei and produce consequent ]v smaller applications programs, 
comi) 1 nni ■' . !. /.* j . ■ . 4 pr.rse spec 1 1 1 cat ions . 
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8.0 ZCPR Version 4. 

Z40.ZRL is a consolidation of ZCPR34 and many of the RCP features common 3 y in 
use. modified by the need to bank as much of the Command Processor as possi- 
ble. When Z40 is used in a Fully-Banked system, you may not need much of. or 
any Resident Command Processor with your system. Z40 relys on ZSDOS 2 and will 
NOT work without it since the Command Line Parser and disk free space calcula- 
tions have been removed in favor of ZSDOS2 services. Additionally, the prompt 
line displays the time and wi J 1 only function correctly if he ZSDOS2 clock is 
enabled. Comments on how these new System components work would be appreciat- 
ed . 

More complete documentation is provided in the Z40.HLP liles included with the 
distribution diskettes, and a list of active functions is available with the H 
command at the prompt. To read the On-line help Piles, use HELP.COM available 
tor downloading from any 2 -Node . 
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Application Programs. in contrast to utility programs {see;, app! ic-at ion 
programs or applications are larger programs such as word processors whies 
function interactively with the user. 

BOOS. Basic Disk Operating System. The machine- independent , hut usually 
processor-dependent, program which controls the interface between application 
programs and the machine-dependent hardware devices such as printers, disk 
drives, clocks, etc. It also establishes the concept of iiles on media arc 
controls the opening, reading, writing, and closing of such constructs. 

BGi i . BaekGrounder j; 1 ron Piu^- Perfect Systems, a windowing task-switching 
system lor OP/M users with ham or RAM disks. 

BIOS. Basic Input/* Ritput system. Machine-dependent routines which perform 
actual peri phera ' acvicc control such as sending and receiving charade: ■- 
‘ nc consol,;, read mg and writing to disk drives, etc. 

tii t . Binary d i e ■ 1 . An element which can have only n smglc on or oil state. 

Bit Map. An arniv <v b i t s use: t o i epre-sem or map large arrays of Pi na 
i m orm:> t i on in n comnact ior»... 

Boot. ■; :k t-. , us d for xh 5, tar; me sequence oi . 1 0. • ; ... :■;■■■ ; ; 

ap'Vjc- to start rr • rot: a 'com.' or nov.v r-c. ' f 'ate. one in. Tubes the ]oa ■- 
ins o' t »iv rat' i it t trstti: and eon! 1 cu . . -on - 1 ens . 

Byte . a cro- ps ns o! d g. a ! 1 . 

C-os;. c (.v’tcok; : '•>. • a. . meat . iB r> i act t CCP I see he iov. .' . txamric: 7 ; IT 

Post;, a ‘’iiao . The portion of the operating system that 
• - comma;!!-'- and cither executes them directly or loads ars’d ■ c : - 
’tom disk for execution. The o P may be overwritten by anpi : ra- 
re j oink-; ' 1 >y x k-j "Wa m Boot " 1 unction of the BIOS. 

Checksum. An value wh 1 c n aritnmet ieai iy surnm.Hr i res the content s of a sen e 
o’ nit- ;«i ij y iocat tors, and used to check the current contents for c rrors . 

Clock Driver. A soltwai'e : ink between a Non- banked ZSDOS and the clock smi 
. vour system. The clock driver allows ZSDOS and its ut.il itie- to read x 1 

clock, which i normally inherent in the B/P Bios. 

Command Script. Sometimes called simply scripts, command scripts a 1 low you * - 
create a single command which issues other commands to perform a unique set 0 : 
actions. CP/M submit files are one kind of command script familiar to a: 
CP/M users. ZCP? also offers more sophisticated types of scripts such a 

aliases and command files (e.g.. ALIAS. CMD) . 
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DateStamper. A software package developed by Pju*Perfect Systems to a i low 
time and date stamping of files. The Boot System uses an external module in 
the file LDDS.CoM to implement DateStamper . while ZSP0S2 automatical' sup- 
ports this stamping method. DateStamper is unique among file stampers for 
microcomputers for two reasons: first, it maintains all file stamps within a 
file: second, it maintains stamps for create, access, and modify time/date for 
each file. 

DDT. Dynamic Debugging Tool. A utility distributed with CP/M 2.2 which can 
display, disassemble, or alter disk files or areas of memory using opcodes or 
hexadec i ma 1 va 1 ues . 

DOS. Disk Operating System. Often used term for the BOOS, but generally 
refers to the aggregate of COP. BDuS and BIOS. 

DosDisk. A software package i rom F-’]u*Perfect Systems which allows user:-, of 
CP/M and compatible computers to write and read tiles directly to and from 
standard 5-1/4" 40- tract Diaibie— Sided. Double- Density Mb-POs format disKetiec. 
Tins is the standard ' 3b 1 /:" di 4: format used in IBM- PC compatible computers. 

FCB. file Control Block. A standard memory structure used by CI7M and com- 
patible operating system-: to regulate -disk f i ic operation . 

Fi le Attributes. Also known a file attributes , reserved bits stored a loin* 
with file names in rii-4 directories winch control how the file- ate accef.se-. . 

Hexadecimal . base- it. number ! ns system consisting of the numbers 0-'-> an- : 
letters A-f . often used to represent bytes as two digits (00 to I; - . 1. s ■ o: 
Hexadecimal numbers is usually represented by suffixing the number w : t n an ! ' 
as in "01 H". 

I0BYTE . Input /Output Byte, 
some 0-7 M R 1 of - ' s u red ; re< 
rials and printers. 

K. Usual iy refers to kilobyte oi 10.14 i. 10th power) byte:- . 

P2D. P2Dos Datestamp-: . An alternat ive form of file stamping used in HAJ i er, 
Brusce " s P2D0S . 1-21> stamps are compatible with CP/M Plus time and date- 
stamps. This format is supported in a B/P boot system with the LDP2D.COM 
Stamp module, and automatically in ZSD0S2 . 

RAM. Random Access Memory. As opposed to Read Only Memory (ROM) the area of 
a computer’s memory which may be both read 1 rom and written to. 

RSX. Resident System Extension. A program module complying with a standard 
developed by Plu*Perfect Systems for extending the functionality of a CP/M 2.2 
compatible Operating System. Tne module must be loaded at the top of the 
Transient Program Area, and below the console Command Processor. 

System Prom.pt I he - ana - iar A> prompt wrw.ch appears soon af ter t P/e comp. -.e.- .- 
are started up. 


A res-..- wred byte at location 2- which j. used ny 
i>, put and output between devices such a-- term:- 
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TPA. Transient Program Area. That addressable memory space from the lowest 
available address to the highest available address. Usually this extends i rom 
lOOH to the base of the BOOS (assuming that the Command processor is overwrit- 
ten ) . or the base of the lowest RSX. 

Utility Programs. In contrast to application programs (see), utility programs 
or utilities are shorter programs, such as directory programs, which accept a 
single command from the user. 

Wheel Byte. Taking its name from the colloquial ’’Big Wheel." the Wheel byte 
controls security under ZCPR and ZSDOS. When the byte is set to a non-zero 
value, the user has "Wheel status" and may execute commands unavailable to 
other users. 

Word, in the computer context, a fixed number of bytes. For 8- bit microcom- 
puters. a word is usually two bytes, or 10 bits. 

Z-System. An operating system which completely replaces CP/M by subs t nut ing 
2' 'PR lor Digital Research's command processor and ZSDOS for Digital Re scare h ‘ s 
disk opera t ing system. ZCPR and ZSl>Ob complement one another in serera i way 
to enhance performance . 

ZCPR. Z>-0 Command Processor Replacement . Original iy developed as group 
effort of the Special Interest Group 1 or Microcomputers ( S1G./M) . but rei ineci 
by Hi chan! Conn to 7\ Pi version .1 . u and .la;, sage to versions .MS ana .1.4. 

ZRL. A form i-s i-.>c«v.abje i i je imaee using specified ' Named common liases . 
For ZS! h )S . fil- ■ ot tins type arc M i c robot t -coinpat : hi e KM fine-- usinr. on'v 
mm ; om;.:oii IMialMv segment " BIOS.'. 
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This manual is not intended ns a complete reference to Z80 assembly language. 

CP/M . or ZCf'R operating systems. Since many books have been written on these 

topics we include here only those we have found most useful . The sources n 

each category are listed in order of difficulty. 

1. Information on CP/M 

Waite, Mitchell and Robert I afore. Soul of CP/M: How to Use the Hidden Power 
of Your CP/M System. Indianapolis: Howard W. Sams & Co.. 1983. Weii 
written basic introduction to the principles and design of CP/M and the 
use of 8080 assembly language. Many programming, examples and several 
useful appendices included. Illustrated, appendices, index. 391 pp. 

Johnson-Lai rd . Andy. The P rog rammer ' s C P/M Handbook. Berkeley: Osborne/ 

Mcgraw-Hi 1 1 . 1 983 . Highly detailed, complete description of the struc- 
ture of CP/M for programmers. Instructions on patching, designing and 
debugging a new CP/M system. complete example BIOS source included. 
Illustrated, appendices, index. 501 pp. 

Digital Research. CP/M Opera; ing system Manual. Pacific Grove. California: 
Digital Research. 19: j. Original documentation by Digital Research, 
developers of t. P/M . Concise and authoritative, and technically v.-. it- 
ten, tnis guide 0 mainly of use as a reference guide for those who 
already understand CP/M. Includes- coverage of the original CP/M utili- 
ties and a skeletal example BIOS. Illustrated, appendices, index. 250 
PP- 

2. Z80 Assembly Language 

Mosul'. Corporation. Procramn. ing Manual for Z80 Mjcrocpn.iput.er . Publication 
No, Mk~h5 1 5 . MOSTKk corp. . lu'7. The "Bible" of Z80 assembly language 
programming witn detailed descriptions and examples of each opcode. 

Hitachi America, j.t 5. HiK>4J 8<) 8-Bit High integration CMOS M icrpproce ssor Data 
hook. Publication *1.77 . Hitachi America. Ltd.. 1 985 . ’lne reference 

book for the 04180. No programming examples, but very detailed list- 
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Number 

Fen Name 

Input Parameters 

Returned Values 

Uses 

0 

CB00T 

None 

None 

A1 1 Regs 

1 

WBCOT 

None 

None 

A1 1 Regs 

2 

CONST 

None 

A=FFH if Ready 

AF 

3 

CONIN 

None 

A=00H if No Char 
A=Char from CON: 

AF 

4 

CONOUT 

C=Char to send 

(masked per ICFG) 
None 

AF 

5 

LIST 

(masked per I CFG) 
C=Char to send 

None 

AF 

6 

AUXOUT 

(masked per I CFG) 
C=Char to Send 

None 

AF 

7 

AUXIN 

(masked per ICFG) 
None 

A=Char from AUX: 

AF 

8 

HONE 

None 

(masked per ICFG) 
< Status Code > 

A1 1 Regs 

9 

SELDSK 

C=Dri ve (0=A..15=P) 

HL=Disk Param Hdr Addr 

All Regs 

10 

SETTRK 

BC-Track Number 

HL=0 if No Drive 
None 

None 

11 

SETSEC 

BC=Sector Number 

None 

None 

12 

SETDMA 

BC=DMA Address 

None 

None 

13 

READ 

None 

< Status Code > 

All Regs 

14 

WRITE 

C=W‘~ite Type 

< Status Code > 

A1 l Regs 

15 

LISTST 

((^Unallocated, 1 =Di rectory , Force Write) 
None A=FFH if PTR Ready 

A r 

16 

SECTRN 

BC= Loci cal Secto:' # 

A=00H if PTR Not Ready 
HL=Physical Sector 4 

A 1 1 Regs 


« End of CP/M 2.2 Vectors »> 

DE=Translation Tbl Addr 

— 

1 7 

CONOST 

None 

A=0FFH if CON: Reaay 

AF 

18 

AUXIST 

None 

A=00H if CON: Busy 
A=0FFH if AUXin Ready 

AF 

13 

AUXOST 

None 

A=00H if No Char 
A=0FFH if AUXout Ready 

AF 

20 

DEVTEL 

None 

A=00H if AUXout Busy 
HL — > Char 10 Table 

HL 

21 

DEVIN I 

None 

None 

A1 1 Regs 

22 

DRVTBL 

None 

HL — > DPH Table if Ok 

HL 

23 

24 

<Reserved 

FLUSH 

for MULTIO 
None 

(0 entries for No Drv) 
< Status Code > 

All Regs 

25 

MOVE 

HL=Source Addr 

None 

A1 1 Regs 

26 

TIME 

DE=Dest Addr 
BC=Length to move 
C=0(Read) , C=1(Set) 

A=1 if Ok, A=0 if Errs 

All Regs 

27 

SELMEN 

DE — > 6 -byte Time 
A=Bank Number 

E=Orig 6 th buffer byte 
D=1/10th Secs (Read) 
None 

None 

26 

SETBNK 

A=Ban* Number 

None 

None 
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29 

XMOVE 
«< End of 

C=Source Bank # 
B=Dest Bank # 

CP/M 3 "Type" Vectors 

None 

None 




30 

RETBIO 

None 

A=Bios Version # 

BC — > Bios Jump Table 
DE — > Config Data Area 

A , BC , DE , HL 




HL — > Device Config Table 

31 

DIRDIO 

< — See details below 

for Direct Device 10 — > 




B=Driver Type 
C=Function # 

<see table> 

<see table> 

32 

STFARC 

A=Bank Number 

None 

None 

33 

FRJP 

HL=Dest Address 

?? 

?? 

34 

FRCLR 

HL=Return Address 

?? 

None 

35 

FRGFTB 

HL — > Byte to Get 

A=Byte at (C:HL) 

AF 



C=Bank Number 



op, 

FRGFTW 

HL — > Word to Get 

DE=Word at (C:HL) 

F , DE 



C=Bank Number 



2 ! 

FRPUTB 

Hl — > Byte Dest 

None 

F 



C=Bank Number 
A=6yte to Put 

(A saved to (C:HL) ) 


Oo 

FRPUTW 

HL — > Word Dest 

None 

F 



C=Bank Number 
DE=Word to Put 

(DE saved to (C:HL)] 


39 

RETMEM 

None 

A=Current Bank Number 

AF 


:r:r=r™:.===ri FLOPPY DISK SUBFUNCTIONS (Function 31) ============ ==-=r 

0 STMODE A=0 (Double Dens) None AF 

OFFH (Single Dens) 

C=C (Fuofcn #) 

B- 1 (FI oppy ) 

1 STSIZE A=0 (Normal Speed) None AF 

OFFH (Hi capable) 

D=Q (Motor On Cont ) 

OFFH (Motor Contr) 

E=0 (Hard), 1 (8") None AF 

2 (5.25"), 3 (3.5") 

C=1 (Subfcn #) 

B=1 (Floppy) 

2 STHDRV A=Unit (B0,1) None AF 

Head (D2) 

C=2 (Subfcn #) 

B=1 (Floppy) 

3 STSECT A=Phys Track # None AF 

D=0 (128 Sctrs. . None AF 

3=1024 Sctrs) 

E=Last Sector # 

C=3 (Subfcn #) 

B=1 (Floppy) 
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4 

SPEC 

A=Step rate in mS 
(B?=1 for 8" Drv) 
D=Head Unload in mS 
E=Head Load in mS 
C=4 (Subfcn #) 

B=1 (Floppy) 

None 

AF 

5 

RECAL 

C=5 (Subfcn #) 
B=1 (Floppy) 

< Status Code > 

AF 

6 

SEEK 

A=Desired Trk # 
D=0FFH Verify, 

E=0 (Single-step) 
<>0 (Double-step) 
C=6 (Subfcn #) 

B-1 (Floppy) 

< Status Code > 

AF 

7 

SREAD 

HL — > Read Buffer 

< Status Code > 

AF , HL 



C=7 (Subfcn #) 
B=1 (Floppy) 



8 

SWRITE 

HL — > Write Buffer' 

< Status Code > 

AF , HL 



C-8 (Subfcn P) 
B=1 (Floppy) 



9 

READ ID 

C=2 (Subfcn P) 
B-'l (Floppy) 

< Status Code > 

AF 

10 

RETDST 

C=10 (Subfcn p) 

A=Status Byte 

AF , BC , HL 



B-1 (Floppy) 

BC=Cont roller Type 
HL — > Status Byte 


1 1 

FMTTRK 

HL— > Format Data 
D=Sctrs/Trk 
F=Gap 3 Byte Count 
C=11 (Subfcn P) 

B=1 (Floppy 1 

< Status Code > 

A1 1 Regs 


======="==:= ======:= hARC DISK SUBFUNCT IONS (Function 31) ===—== 


0 

HQVALS 


0E— > 

512 byte Bu T 'f 

A-# Bytes in CDB 

A c ,Hl 




n—', 

'■w'” W 

(Subfcn p) 






B-2 

( Hard ) 



1 

HDSLCT 


A=De 

vice Byte 

A=Physical Device Bit 

AF 




C=1 

(Subfcn #} 






B=2 

(Hard ) 



2 

DOSCSI 


DE— > 

Comnd Desc Blk 

H=Message Byte 

A1 1 Regs 




A=0 

(No Write Data) 

L=Status Byte 





C=2 

(Subfcn #) 

A=Masked Status Byte 





B=2 

(Hard) 



Status Code: 

A 

- o 
w ? 

Zero Set (Z) if 

Operation successfully 

performed 



A 

<> 0, 

Zero Clear (NZ) 

if Errors occu red in Operation 
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Number 

Function name 

Input Parameters 

Returned Values 

0 

Boot 

None 

None 

1 

Console Input 

None 

A=Character 

2 

Console Output 

E=Character 

A=OOH 

3 

Reader Input 

None 

A=Character 

4 

Punch Output 

E=Character 

A=OOH 

5 

List Output 

E=Character 

A=OOH 

6 

Direct Console I/O 

E=OFFH (In) 

E=OFEH (In) 

E=OFDH (In) 

E=OOH . . OFCH (Out) 

A=Input Character 
A=Console Status 
A=Input Character 
A=00H 

7 

Get I/O Byte 

None 

A=I/0 Byte (0003H) 

8 

Set I/O Byte 

E=I/0 Byte 

A=00H 

g 

Print String 

DE=Address String 

A=OOF 

1 n 

Read Console Buffer 

DE=Address Buffer 

A=00H 

1 1 

Get Console Status 

None 

A=OOH. - No character 
A=01H = Char, present 

i 

Get Version Number 

None 

A=Version Number (22H 

13 

Reset Dish System 

None 

A=OOH No $*.* on A 
A=FFH $* . * on A 

14 

Select Disk 

E-Disk Numbe r 

A=00H No $*.* File 


A=FFH Flit 


1 C 

Open File 

DE=Address of 

FCB 

A=Di rectory Code 

16 

Close F ■ 1 e 

DE=Address of 

FCB 

A=D _: rectory Cede 

17 

Search for First 

DE-Address of 

FCB 

A-Di rectory Cooe 

ie 

Search for Next 

DE-r-.udress of 

FCB 

A=Di rectory Code-; 

1 s 

De 1 e t e File 

DE=Address of 

FCB 

A.-Error Code 

20 

Read Sequential 

DE=Address of 

FCB 

A=Read/Wri te Code 

21 

Write Sequential 

DE=Address of 

FCB 

A~Read/Write Code 

22 

Make File 

DE=Address of 

FCB 

A~Di rectory Code 


Rename: F - 1 e 

DE=Add-ess of 

FCE 

A=Error Code 


Get Login Vector 

None 


HL-Login Vector 

Of: 

Get Current Dis 1 

None 


A=Current D‘ : sk 

26 

Set DMA Address 

DE=DMA Add res: 

3 

A=00H 

2 ■ 

Get Alloc. Address 

None 


HL=Addr Alloc Vector 

o r-, 
CC, 

Write Protect Disk 

None 


A=00H 

29 

Get R/O Vector 

None 


HL=R/0 Vector 

30 

Set Fi le Attributes 

Dt=Address FCB 

A=Error Code 

31 

Get D D B Address 

None 


HL=Address of DPB 

32 

Set/Get User Code 

E=FFH (Get) 


A=User Numbej - 



E=User Number 

(Set) 

A=00H 

on 

Read Random 

DE=Address of 

FCB 

A=Read/Write Code 

34 

Write Random 

DE=Address of 

FCB 

A=Read/Write Code 

36 

Compute Fi le Size 

DE=Address of 

FCB 

A=Error Code 

36 

Set Random Record 

DE=Address of 

FCB 

A=00H 

37 

Reset Mult Drive 

DE=Mask 


A=00H 

38 

Not Implemented 




39 

Get fixed disk vector 

None 


HL=Fixec Disk Vector 

40 

Write random . 00 fill 

DE=Abd’~ of FCI 


A=Read/Write Code 

4 1 -A4 

Not Implemented 
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45 

Set error mode 

E=FFH (Get) 

A=00H 



E=FEH (Get Err/Disp) 

A=00H 



E=01 H (Set ZSDOS ) 

A=00H 



E=00H (Set CP/M) 

A=00H 

46 

Return Free Soace 

E=Disk Number 

A=Error Code 




Space in DMA+0..DMA+3 

47 

Get DMA address 

None 

HL=Current DMA Address 

48 

Get DOS & version 

None 

H=DOS type: "S''=ZSD0S 




"D"-ZDDOS 




L=BCD Version Number 

49 

Return ENV Address 

None 

HL=Env. Descriptor Addr 

50-97 

Not Implemented 



98 

Get time 

DE=Address to Put Time 

A=Time/Date Code 

99 

Set time 

DE=Address of Time 

A=Time/Date Code 

1 00 

Get flags 

None 

HL^Fl ags 

101 

Set flags 

DE-Flags 

None 

102 

Get file stamp 

DE=Addr of FCB 

A=T i me/Dat e Code , 




Stamp in DMA Buffer 

102 

Set file stamp 

DE=FC6 Address , 

A-Time/Date Code 



Stamp in DMA Butter 


104-151 

Not Implemented 



15? 

Parse FileSpe: 

DE=FCS Address, 

A=N.o . of "? "s in f : i . F r 



Sx -i p r Q i n DMA B'j f f & 

DF ~f- 3 a ■ of del in t c h ; 


FCB-15=0 if Pa ’'sc Ok 
O ir FH if Error (s 

153-255 Not Implemented 


Directory Codes: 

a- do; : , 

A-FFr 

01li, 02 K, c 

if Error 

CH it No Error 

Error Codes: 

A-00H 

it No Error 

A=0FFH if erro 

Time/Date Codes: 

A-OIH 

:r Nc error 

A=0FFH i + errc 

Read/Write Codes: 

A=00H 

if No error 



A=01H Read => End of File 


Write =>Di rectory Full 
A=02H Disk Full 

A-03H Close Error in Random Record Read/Write 
A=04H Read Empty Record during Random Record Read 
A=05H Directory Full during Random Record Write 
A=06H Record too big during Random Record Read/Write 

Extended Error codes in Return Error Mode: 

A-QFFH Extended Error Flag 

H-01H Disk I/O Error (Bad Sector) 

H~02H Read Only Disk 

H- 03 H Write Protected File 

H=04H Invalid D r i ve (Select ) 
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Dstespec and File Stamp Formats 


The universal stamp and time formats used by ZSDOS are based on packed BCD 
digits. It was decided that these were the easiest format for Z 80 applica- 
tions programs to work with, and were compatible with most real time clocks. 
The format for the stamps and for the clock functions are identical to the 
Plu*Perfect DateStamper ’ s formats for these functions. 

Some file stamping formats (for example CP/M Plus type) do not store all the 
information present in the universal format to disk. In the case of CP/M Plus 
type stamps, there is no provision for stamping the Last Access time. Tne 
ZSDOS interface routines fill unimplemented fields in the stamp with 0 when 
the Get Stamp function is used, and ignore the contents of the unused fields 
when the Put Stamp function is used. 

Depending on the stamping method selected, the format of the stamps on the 


di 

sk may 

differ 

from tne 

jrp 

versa! format. 

These dif 

terence 

s are 

effective ; y 

h^ 

dden from user 

s by ZSDOS 

a 

nd the Stamp routines so 1 

ong as 

ZSDOS 

'$ func 1 ions 

5 r 

e used 

to get 

or man i pul 

cl 

e the stamps. 






Time 

format 

(6 bytes 

packed BCD): 







TIMF.+C 

• last 2 

ch 

gits of year 








(pref i 

/ 

I 9 assumed for 

78 to 99, e 

Ise 20 

ass J r m 

..d } 



TIMF+1 

- month 

; i 

. 1 2 1 







TIMl+C 

- day 

[1 

. .31 ) 







TIME-' G 

- hour 

L <v -' 

. .23] 







T I ME+-- 

- minute 

i /■' 

fvCl j 







T I ME+5 

- second 

L *'-• 

* • C- d j 






File Stamp format (15 bytes packed BCD): 


DMA-i 0 

- Create field 

t ti rst 

5 

bytes 

of 

t i m 4 

format 

DMA-' 5 

- Access field 

( f -I rst 

5 

bytes 

of 

time 

format 

DMA 4 ' o 

- Mod i f y f i e i c 

(, f i rst 

c; 

bytes 

o~ 

t i me 

format 
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Absolute System Model, 108 
ALIAS, 69 
ALIEN.DAT, 85, 96 
ALV, 47, 55, 57, 143 
Application Programs, 145 
Archive, 91 , 93 
Assembly, 7, 10 
AutoSize, 67 
Auxiliary, 28 

Bank number , 47 , 70 
Banked Bios, 9, 11 
Base Page, 7 
Baud Rate, 72 
BDQS, 109, 145 
BG-ii, 145 

Bios, 64, 103, 145 
Bit Map, 145 
Boot , 1 45 

Boot tracks, 14, I 7 , IS. 71, 
BPBUILD, 64 

BPCNi-G, 1C, 19, 63, 93, 123 
BPDBUG , 77 
6PFORMAT, 83, 35 
BPSWAP . 37 

BPSYSGEN, 16, IS, 89. 98. 1'5 
Breakpoint. 81 , 83 
Byte, 145 

CCP, 109, 145 

Character Device. 51, 7 i 

Checksum. 145 

Clock, 34. 70 

Clock driver, 120, 145 

CLOCKS . DAT , i 20 

Cold Boot, 68 

Command Script, 145 

COMMON bases , 64 

Common Memory, S, 11 

Configuration, 68 

Controller types, 83 

COPY, 91 

CP/M, 2 

CPF, , 64 

CSV, 47 

Data Structures. 45 
DateStampe r , 34, 14:, 146 
DDT, 146 
Disassembly, 80 


Disk Change, 133 

Disk Parameter Block (see DPB) 

Disk Parameter Header (see DPH) 

Dos , 64 , 146 

DosDisk, 141, 146 

DPB, 55, 83 

DPH, 29, 33, 52 


EMULATE, 84, 96 
Environment Descriptor, 58 


FCB, 146 

File Attributes, 146 
Files, 10 
Format, 83 
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0 (Bios), 

25 

Function 

1 i 

( Bios ) , 

26 

Function 

2 i 

(Bios ) , 

26 

Function 

3 ! 

( Bios ) , 

27 

Function 

4 

( Bios ) , 

27 

Function 

5 

( Bios ) , 

27 

Function 

6 

(Bios) , 

28 

Function 

7 i 

(Bios) , 

28 

Function 

8 

(Bios), 

28 

Function 

3 

(Bios) , 

29 

Function 

10 

(Bios) , 

29 

Function 

1 1 

(Bios ) , 

29 

Function 

1 2 

(Bios) , 

, 30 

Function 

13 

( Bios j 

, o' u 

Function 

14 

( Bios 1 

, 30 

Function 

15 

(Bios ; 

06; 
i '-H-. 1 

Function 

16 

{ Bios ) 

. 31 

F unci i on 

17 

( Bios) 

'V < 

Function 

18 

( Bios ) 

, 31 

Function 

19 

(Bios ) 

, 32 

Function 

20 

(Bios) 

, 32 

Function 

21 

(Bios ) 

, 32 

Function 

22 

(Bios j 

, 33 

Function 

23 

(Bios ) 

, 33 

Function 

24 

(Bios) 

, 33 

Function 

25 

(Bios ) 

, 33 

Function 

26 

(Bios) 

, 34 

Function 

27 

( Bios ) 

j u4 

Function 

28 

(Bios ) 

, 34 

Function 

29 

(Bios) 

, 35 

Function 

30 

(Bios) 

, 35 

Function 

31 

(Bios) 

, 36 : 
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Floppy SubFunction 4, 


42, 43 

36 

'k 0 

37 
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, 44 
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, 44 

Function 36 (Bios) 

, 44 
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, 45 

Function 38 (Bios) 

, 45 

Function 39 (Bios) 

, 45 

Function 4C (Dos), 

'! 4 3 

Function 49 (Dos). 

142 

Function 99 (Dos), 

1 26 

Function 152 (Dos) 

, 143 

Hard Drives, 98 


HD800T. 19, 98 


HD I A3. 1 00 


HELP, 144 


Hexadecimal , 146 


Identifiers. 46 


Image, 19 


Image (IMG) file, ( 

: c: 1 ■■■ , 

. ' w* * i : . 

1NIRAMD, 104 


INITDIR , 108 


INSTAL12, 18, 108, 

1 1 5 

Installation, 17 


INSTALOS, 10S 


IOBYTE, 4, 26. 27. 

28, 3 

51 , 

71 , 7; 

I OP, 114 


IOPINIT, 114 


Jump table, 25 


K, 146 


Landing zone, 119, 

1 24 

LDSYS, 19, 68, 115 



MGOPY 48 9 I 

Memory, 7 


Memory Bank, 34, 78 
Memory map, S 
Modules, 10 

M0VCPM, 11, 14, 18, 108 
MOVxSYS, 18, 115, 117 
MOVZSYS, 18, 108 

Named COMMONS , 64 
No-Slot-Clock, 126 
Non-Banked system, 9, 17 
NZBLITZ , 3 
NZCOM, 3, 26 

Options, 11 

P2D0-S, 141 . 146 

PARK , 119, 124- 

Parse, 143 

Path. 132, 133 

Programming, 25 

PUB lie, 92, 97, 120, 132 

RAM, 146 
RCP, 21 . 144 
Read-Only, 132 
REl , 54, 110 
RSX, 146 

SASI , 42, 50, 74 
SCSI, 42, 50, 74 
SCSI-2, 74 
Sense, 102 
StTCLOK, 120 
SHOWHD, 75, 123 
SmartWatch, 126 
SPINUP, 119, 124 
Stack Switcher, 44 
Stamp Create, 137 
Stamp Last Access, 136 
Stamp Modify, 137 
STARTUP, 16, 21, 69, 105. 114, 
120 

Step rate, 73 
Syntax, 2 

System Attribute, 133 
System Bank, 9, 11 
System Prompt, 146 

Tailoring, 7, 10, 46 
TCAP, 60 
TDD. 125 
TERM-CAP, 60 
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Wait states, 49, 70 
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Wheel, 85, 135, 139, 147 
Word, 147 

XBIOS, 3 
XD III, 139 
XDPB, 55 
XDPH , 49, 52 

Z-System, 7, 147 
Z40 , 144 

ZCPR. 58, 144, 147 
ZRDOS , 2 

ZRL, 64, 110, 147 
ZSCFG2, 129 
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INTRODUCTION 


1.0 Introduction. 

The Banked and Portable (B/P) Basic I/O System (BIOS) is an effort to stan- 
dardize many of the logical to physical mapping mechanisms on Microcomputers 
running Z-Svstems with ZSDOS. In expanding the capabilities of such systems, 
it became apparent that standard BIOSes do not contain the funct iona 1 i ty 
necessary, adequate standardization in extended BIOS calls, nor an internal 
structure to fully support external determination of system parameters. B/P 
Bios provides a method of achieving these goals, while also possessing the 
flexibility to operate on a wide range of hardware systems with a much smaller 
level of systems programming than previously required. 


1.1 About This Manual. 

Documentation on B/P Bios consists of this manual plus the latest addendum on 
the distribution disk in the file README. 2ND. This manual is divided into the 
following sections: 

o The Features of B/P Bios summarizes the significant features of B/P 
Bios in general, highlighting advantages and the few limitations 
in the system. 

o Tailoring B/P Bios contains details on altering the many options to 
generate a customized . Fill, file tailored to your system. 

e Installing a B/P Bios details the installation of B/P Bios in both 
UnbanktJ and Banked configurations in a "how to" fashion. 

o Programming for B/P Bios describes the interfaces, data structure 1 , 
and recommended programming practices to insure the maximum 
benefit and performance from systems with B/P Bios. 

o The B/P Bios Utilities describes the purpose, operation, and custom- 
ization of all supplied B/P Bios utilities and support routines. 

o Appendices which summarize various technical information. 

o A glossary defining many technical terms used in this Manual. 

o An index of key words and phrases used in this Manual . 

For those not interested in the technical details, or who want to bring the 
system up with a pre-conf igured version as quickly as possible. Section 4. 
Installing a B/P Bios, will lead you through the installation steps needed to 
perform the final tailoring to your specific computer. Other chapters cover 
details of the individual software modules comprising the B/P Bios, and spe- 
cifics on the utilities provided to ease you use of this product. 
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1.2 Notational Conventions 

Various shorthand terms and notations are used throughout this manual. Terms 
are listed in the Glossary at the end of this manual. 

Though the symbols seem cryptic at first, they are a consistent way of briefly 
summarizing program syntax. Once you learn to read them you can tell at a 
glance how to enter even the most complicated commands. 

Several special symbols are used in program syntax descriptions. By conven- 
tion, square brackets ([]) indicate optional command line items. You may or 
may not include items shown between brackets in your command, but if you do 
not, programs usually substitute a default value of their own. If items 
between brackets are used in a command, all other items between the brackets 
must also be used, unless these items are themselves bracketed. 

All of the support utilities developed to support the B/P Bios system contain 
built-in help screens w'hich use the above conventions to display helpful 
syntax summaries. Help is always invoked by following the command with two 
s 1 a she s ( // ) . So f or examp 1 e . 

ZXD // 

invokes help for ZXD. the ZSDOS extended directory program. Interactive ZSDOS 
programs such as BPCNFG2 also contain more detailed help messages which appear 
as a session progresses. 


Many utilities may be invoked from the command line with options which command 
the programs to behave in slightly different ways. By convention, options are 
given after other command parameters. For example, the P option in the com- 
mand 


ZXD *.* P 

causes the ZXD directory utility to list all files (*.*) and send its output 
to the printer (P). For convenience, a single slash character (/) can often 
be used in place of leading parameters to signify that the rest of the command 
line consists of option characters. Therefore, the command 

ZXD /P 

is identical in meaning to the previous example (see 6.23 for more on ZXD). 


1.3 What is B/P Bios? 

B/P Bios is a set of software subroutines which directly control the chips and 
other hardware in your computer and present a standard software interface to 
the Operating System such as our ZSDOS/ZDDOS, Echelon's ZRDOS, or even Digital 
Research's CP/M 2.2. These routines comply with the CP/M 2.2 standards for a 
Basic 10 System (BIOS) with many extensions; some based on CP/M 3.x (aka CP/M 
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Plus), and others developed to provide necessary capabilities of modern soft- 
ware. When properly coded, the modules comprising a B/P Bios perform with all 
the standard support utilities, nearly all Z-Svstem utilities, and most appli- 
cation programs without alteration. 

The ability to operate Banked. Non-banked and Boot System versions of the Bios 
with a single suite of software, across a number of different hardware ma- 
chines, plus the maximization of Transient Program Area for application pro- 
grams in banked systems are features which are offered by no other system of 
which we are aware. 


1.3 The History of B/P Bios. 

Our earlier work developing ZSDOS convinced us that we needed to attack the 
machine-dependent software in Z80-compat ible computers and develop some stan- 
dard enhancements in order to exercise the full potential of our machines. 
This premise is even more true today with large Hard Disks (over 100 Mega- 
bytes) being very common, needs for large RAM Drives, and an ever shrinking 
Transient Program Area. Attempts to gain flexibility with normal operating 
systems were constrained by the 64k addressable memory range in Z80-compat ible 
systems, and forced frequent operating system changes exemplified by NZCO.M and 
NZBLITZ where different operating configurations could be quickly changed to 
accommodate application program needs. 

In the mid to late 19S0's, several efforts had been made to bank portions of 
CP/M 2.2 "type" systems. XBIOS was a banked Bios for only the HD64 180- based 
MicroMint SB-180 family. While it displayed an excellent ancl flexible inter- 
face and the ability to operate with a variety of peripherals, it had several 
quirks and noticeably degraded the computer performance. A banked Bios was 
also produced for the XLM-180 single board S-100 computer, but required spe- 
cial versions of many Z- System utilities, and was not produced in any signifi- 
cant quantity. Other spinoffs, such as the Epson portable, attempted banking 
of the Bios, but most failed to achieve our comprehensive goals of compatibil- 
ity with the existing software base, high performance, and portability. 

In 1989. Cam developed the first prototype of B/P Bios in a Non-banked mode on 
his TeleTek while Hal concentrated on extending ZSDOS and the Command Proces- 
sor. As of mid- 1992, B/P Bios has been installed on: 


YASBEC - 

Ampro LB w/MDISK 
MicroMint SB-180 
Compu/Time S-100 
Teletek - 


Z180 CPU, FD1 FDC , DP8490 SCSI, 1MB RAM 
Z80 CPU, FD1770 FDC, MDISK 1MB RAM 
HD64180 CPU, SMS9266 FDC, 256KB FLAM 
Z80 CPU, FD1795 FDC, 1 MB RAM 
Z80 CPU, NEC? 65 FDC. 64KB RAM 
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2 Features of B/P Bios. 

B/P BIOS is designed to be completely compatible with the CP/M 2.2 standards 
for a Basic 10 System, as well as to provide many extensions needed for banked 
memory which is becoming so prevalent with newer systems and processors. 
Additionally, strict coding standards used in the various modules forming the 
BIOS ease interface problems with applications programs and provide a more 
robust framework for future development. The extensions added to the basic 
CP/M 2.2 foundation include many elements from Digital Research's CP/M 3 (aka 
CP/M Plus), but in a more logically consistent manner. Also included in 
banked versions are provisions for managing up to 8 MB of extended memory for 
banked applications, RAM Drives and potentially multitasking in future ver- 
sions. To provide insight into the methodology used, let us now examine some 
of the features in a generic B/P Bios. 


2.1 Character 10. 

As defined by Digital Research in their CP/M 2.2 standards, character 10 
consisted of logical devices referred to as TTY, CRT. UC1, CON. etc. B/P Bios 
extends and generalizes these interfaces using the IOBYTE to define four 
physical devices called C0M1 , COM2. PIO and NUL. The first two. COM! and 
COM2, are serial ports; PTO is a Parallel port, while NUL is a "bit-bucket" 
which can be replaced by a customized driver, or used in lieu of an actual 
device. Digital Research provided only a limited interface capability to the 
character devices in CP/M 2.2. consisting of a Console (CON), an auxiliary 
Input and Output (RDR/PUN), and a Printer (LST). The ability to sense Input 
and Output Status with these devices was extremely limited and was enhanced in 
CP/M 3. These enhanced capabilities are completely incorporated into B/P Bios 
with the addition of strict register usage so that only relevant registers, may 
be altered in the respective routines. By manipulating the IOBYTE, any of the 
four physical devices may be used in the three logical devices of CONsoie. 
AUX i 1 i a r y . and Printer ( LST ) . 

Also featured in B/P Bios are modifications of CP/M 3 functions to initialize 
(or re-ini tialize ) all devices and parameters, and return the address of a 
table which contains names and parameters of the defined character devices. 
While not totally compatible with CP/M 3 equivalents, these functions are 
consistent with the spirit and functionality needed with this advanced system. 
Included in the device table are; flags defining whether the device is capable 
of Input. Output or Both, Data rates for serial devices (Maximum and Set), 
Serial data format where applicable, and Handshaking method (CTS/RTS, XON/XOFF 
or None), as well as Input and Output Data masks for stripping unneeded bits 
from characters during 10. 


2.2 Mass Storage 10. 

All versions of Digital Research's CP/M BIOSes define only a generic Disk 
driver with implementations of Floppy. Hard. RAM and Tape drives left to the 
user or developer. In B/P Bios, we went several steps further to ease many 
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problems. First, we retained all standard CP/M 2.2 functions and parameters, 
added CP/M 3 features for returning the Disk Parameter Header (DPH) table 
address, and flushing of the software deblocking code segment, and added a new 
vector to the BIOS jump table to provide a standard method of directly ad- 
dressing low-level device functions. Several standard low-level Floppy Disk 
functions are supported and used by the standard utilities, including a func- 
tion to return the type of Disk Controller in use which permits a single 
support utility to adapt to a wide variety of hardware platforms. In a like 
manner, low-level functions are provided for SCSI/SASI Hard Disk drives, and 
provisions for RAM Disk drives in the event special hardware is implemented. 
The methods used to implement these access mechanisms may be logically extend- 
ed to handle Tape Drives or Network Interfaces. 


2.3 Clock Support for Time and Date. 

Many Hardware vendors have added provisions for Time and Date as non-standard 
extensions to CP/.M 2.2 BIOSes, and more have incorporated such support into 
CP/M 3 BIOSes. We opted to define the CP/M 3 clock vector as a ZSDOS-standarri 
clock building on our previous Operating System work. This entry point into 
the Bios completely complies with our ZSDOS standards and can completely 
replace the separate clock driver when used with ZSDOS. For systems capable 
of returning tenths-of-seconds . such as the YASREC and SB-180, the standard 
has been enhanced to support this capability as well. 


2.4 Banked Memory Support. 

While Digital Research added banked memory support to their CP/M 3, it was in 
a manner incompatible v, j th Bios interface standards defined for earlier CP/M 
standards. The method used in B/P Bios is compliant with CP/M 2.2 in direct 
accessing o i Bios functions with only one minor exception when using the 
Banked ZSD0S2 . and contains many of the CP/M 3 extensions added for banked 
memory support, with some being modified to be consistent with standards 
adopted for /-System software. The exception to CP/M 2.2 accesses occurs when 
the Operating System can access certain buffers in the System Memory Bank. 
With ZSDOS 2. Allocation Bit Buffers (ALA’), Check Buffers (CSV) . and the Disk 
Host Buffer are all contained in the System Bank and not directly accessible 
from Transient Programs. To compensate for this, we have added a command to 
ZSDOS 2 to return the free space on disks (the most common reason for access- 
ing these buffers) and tailored several utilities to adapt to banked and non- 
banked systems. 

In addition to the primitives initiated by Digital Research, we added func- 
tions to directly access Words and Bytes in extended banks of memory. Directly 
accessing software routines contained in alternate memory banks, and properl} 
managing the system when errors occur. These features make B/P Bios much mort 
robust and resilient than other products. These features are implemented by 
methods transparent to the system utilities so that the same functions are 
available in both banked and non-banked versions. 
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2.5 Other Features. 

B/P Bios contains a standardized identification method which may be used to 
determine the hardware on which the software is operating. This allows appli- 
cations to "adapt” to the environment in a manner similar to that used in the 
rest of the Z-System community. It also minimizes system "crashes" by execut- 
ing programs which assume certain hardware features w'hich may be detrimental 
if executed on other systems. The effects of identification of physical 
system parameters is most readily noticed by virtue of a single suite of 
support programs performing low-level functions such as formatting and diag- 
nostics w'hich function across widely differing hardware platforms. Portabili- 
ty on this scale can rarely be seen in other computer systems. 

The ZCPR 3.4 Environment with extensions is mandatory in a B/P Bios system. 
Beginning with the addition of System Segment address and size information for 
CPK, DOS and BIOS which were added in the ZCPR 3.4 Environment. B/P Bios also 
adds a Resident User Space which may be used to locate unique routines for 
custom applications in a manner similar to. but more consistent than NZ-COM. 
An Environment Version number of 90H identifies the Z3 Environment as being 
compliant with B/P definitions. 

In Banked systems, application programs may also be placed in alternate memory 
banks using location and sizing information contained at standard positions 
within the Bios Header Structure. This feature permits significantly greater 
functionality without sacrificing precious Transient Program Area. While the 
scheme employed in the initial distribution is subject to minor adjustments as 
tlu banked ZSD0S2 becomes more firmly developed, experimentation and sugges- 
tions into this realm are encouraged. 
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3. Tailoring a B/P Bios. 

To customize a B/P Bios for your use, or adapt it to a new hardware set, you 
will need an editor and an assembler capable of producing standard Microsoft 
Relocatable files. Systems using the Hitachi HD64180 or Zilog Z1S0 must be 
assembled with either ZMAC or SLR180 which recognize the extended mnemonic- 
set, or with a Z80 assembler and MACRO file which permits assembly of the 
extended instructions. For Z80 and compatible processors, suitable assemblers 
include ZMAC and Z80ASM. For any assembler, failure to produce standard 
Microsoft Relocatable code will preclude the ability of our Standard utilities 
to properly install B/P Bios systems. 


3.1 Theory of Operation. 


In order to understand the need for, and principles behind B/P Bios, you must 
understand the way in which CP/M 2.2. as modified by the Z-System. uses t lie 
available memory address space of a Z80 microprocessor. For standard versions 
of CP/M and compatible systems, the only absolute memory addresses are con- 
tained in the Base Page which is the range of 0 to 100H. All addresses above 
this point are variable (within certain limits). User programs are normally 
run from the Transient Program Area (TPA) which is the remaining space after 
all Operating System components have been allocated. The following depicts 
the assigned areas pictorial ly along with some common elements assigned to 
each memory area: 


FFFFH r 


7-8 


ye ran, Buffers 


B • os 


01 00H 
0000H 


Operating System 
Command Processor 
Transient 
Program 
Area 


Base Page 


ENV, TCAP, I OP, FCP, RCP 
Code + ALV, CSV, Sector Buffet s 
CP/M 2.2, ZRDOS , ZSD0S1 
CCP, ZCPR3.X 


IOBYTE, Jmp WB, Jmp Dos, FC8, Buffer 


As more and more functionality was added to the Z-System Buffers, bigeer 
drives were added using more ALV space, and additional functionality was added 
to Bios code in recent systems, the available TPA space has become increasing- 
ly scarce. 

B/P Bios attacks this problem at the source in a manner which is easily adapt- 
able to different hardware platforms. It uses additional memory for more than 
the traditional role of simple RAM Disks, it moves much of the added overhead 
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to alternate memory banks. The generic scheme appears pictorial lv as: 

FFFFH 


8000H 


0000H 



TPA 


SYSTEM 


USER 


RAM DISK 


As can be seen from the above diagram, multiple banks of memory may be as- 
signed to different functional regions of memory, with each 32k bank (except 
for the one defined as BNK1) being switched in and out of the lower 32k of the 
processor’s memory map. The bank defined as BNK1 is ALWAYS present and is 
referred to as the Common Bank. This bank holds the portions of the Operating 
System (Command Processor. Operating System, BIOS, and Z-System tables) which 
may be accessed from other areas, and which therefore must always be "visible" 
in the processor's memory. It also contains the code to control the Bank 
switching mechanisms within the B/P Bios. 

To illustrate this functional division, the memory map of a basic B/P Bios 
system is divided as: 


FFFFH 


01 00H 
0000H 


Z-System Buffers 


User Space 


Bios 


Operating System 


Command Processor 


8000H (- Transient 


Program 


Area 


Base Page 


TPA (BNK0/BNK1) 


Bios Buffers 
Banked Bios Part 


Banked Dos Part 


Banked CCP Part 


CCP Restoral 


Base Page Copy 


System Bank (BNK2) 


8000H 


0100H 

0000H 
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The B/P Bios banking concept defines a one byte Bank Number permitting up to 8 
Megabytes to be directly controlled. Certain assumptions are made in the 
numbering scheme, the foremost of which is that BNKO is the lowest physical 
RAM bank. BNK1 is the next incremental RAM bank, with others follow in incre- 
menting sequential order. A couple of examples may serve to illustrate this 
process. The YASBEC is offered with a couple of options in the Memory Map. 
Units with the MEM-1. 2 or 3 decoder PALs assign the first 128k bytes of 
physical memory to the Boot ROM, so BNKO is set to 4 (Banks 0-3 are the ROM). 
The MEM-4 PAL only uses the first 32k (Physical Bank 0) for the ROM which 
means that BNKO is assigned to 1, BNK1 to 2 and so on up to the 1 Megabyte 
maximum where BNKM is 31. 

The Ampro Little Board equipped with MDISK, on the other hand, completely 
removes the Boot ROM from the memory map leaving a maximum of 1 MB of contigu- 
ous R.AM space. In this system, BNKO is set to 0 and BNKM to 31 of a fully 
equipped 1 MB MDISK board. 

The region beginning after BNK1 is referred to as the System Bank. It begins 
at the bank number assigned to BNK2 and ends at the bank number immediately 
before that assigned to the User Bank, BNKU if present, or BNK3 if no User 
Bank area is defined. 

If present, one or more 32k banks of memory may be defined with the BNKL' 
equate for unique user programs or storage areas. This area begins with the 
bank number set to the label and ends at the bank number immediately before 
the BNK3 label. BNK3 defines a high area of physical memory which is most 
often used for a RAM Disk providing fast temporary workspace in the form of an 
emulated disk drive. 

B/P Bios contains protection mechanisms in the form of software checks to 
insure that critical portions of the memory map are enforced. In the case of 
Non-banked systems, a check is made to insure that the system size is not so 
great that the Bios may overwrite reserved Z-Svstem areas in high memory (RCP. 
IOP, etc). II a possible overflow condition is detected, the message 

++ mem ovfl ++ 


will be issued when the system is started. In Banked Bios systems, this 
message will be displayed if the top of the system portions in the SYStem Bank 
exceeds the 32k bank size. For most systems, this space still permits drives 
of several hundred megabytes to be accommodated. 


Since the Common portions of the operating system components must remain 
visible to applications, a similar check is made to insure that the lowest 
address used by the Command Processor is equal to or greater than 8000H. This 
factor is checked both in both MOVxSYS and BPBUILD with either a warnin 


issued in the 
the latter. 


case of the former, or validity checks on entrv in the case ol 


o 
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3.2 B/P Bios Files. 


This BIOS is divided into a number of fiJes. some of which depend highly on 
the specific hardware used on the computer, and some of which are generic and 
need not be edited to assemble a working system. Much use is made of condi- 
tional assembly to tailor the resulting Bios file to the desired configura- 
tion. The Basic file. BPBIO-xx.ZSO, specifies which files are used to assem- 
ble the Bios image under the direction of an included file, DEF-xx.LIB. It is 
this file which selects features and contains the Hardware-dependent mnemonic 
equates. By maintaining the maximum possible code in common modules which 
require no alterations, versions of B/P Bios are relatively easy to convert to 
different machines. The independent modules used in the B/P Bios system are: 


BOOTRAM. Z80 

BOOTROM . Z80 

BYTEIO.Z80 

DEBLOCK. Z80 

DPB.LIB 

DPB8.LIB 

DPB2.LIB 

DPBRAM.LIB 

DPH.LIB 

FLOPPY. Z80 

SECTRAN . Z80 

SELFLP1 . Z80 

SELFLP2 . Z80 

SELRWD.Z80 

Z3BASE.LIB 


- (only needed in BOOT ROM applications) 

- (only needed in BOOT ROM applications) 

- Character 10 per IOBYTE using IIO-xx routines 

- Disk Deblocking routines 

- 3.5/5.25" Floppy Format Definitions (if AutoSelect) 

- 8"/Hi-Density Floppy Format Definitions (if AutoSelect) 

- Additional Floppy Definitions (optional if AutoSelect) 

- Fixed Floppy Format Definitions (if Not AutoSelect) 

- Disk Parameter Header Table k Floppy definitions 

- Floppy Disk High-Level Control 

- Sector Translate routines 

- Floppy Select routine (if Not auto selecting) 

- Floppy Select routine (if auto selecting) 

- Generic Read/Write routines 

- ZCPR 3.x file equate for Environment settings 


Other files are hardware version dependent to varying extents. These modules 
requiring customization for different hardware systems are given names which 
end with a generic "-xx" designator to identify specific versions. Tailoring 
these modules ranges from simple prompt line customization to complete re- 
writes. Versions of B/P Bios generated to date are identified as: 


"- 18” - MicroMint SB- ISO 

”-YS" - YASBEC 

"-AM” - Ampro Little Board 

"-CT” - Compu/Time S-100 board set 

”-TT" - Teletek 


(64180 CPC , 9266 FDC, 5380 SCSI I 
( Z1S0 CPU, 1772 FDC, DP8490 SCSI) 
(ZSO CPU, 17?0 FDC, 1MB MDISK) 

( Z80 CPU, 1795 FDC, 1MB Memory) 
(ZSO CPU, 765 FDC) 


Files associated with specific hardware versions or require tailoring are: 


BPBIO-xx . Z80 
CBOOT-xx . Z80 
DEF-xx.LIB 
DPBHD-xx .LIB 
DPBM-xx .LIB 
DPHHD-xx.LIB 
DPHM-xx.LIB 
FDC-xx . Z80 
HARD-xx.ZSO 


Basic file, tailored for included file names 

Cold Boot routines, Sign-on prompts 

Equates for option settings, mode, speed, etc. 

Hard Drive Partition Definitions (optional) 

Ram Drive Definition (optional) 

Hard Drive DPH definitions (optional) 

Ram Drive DPH Definition (optional) 

Floppy Disk Low-Level interface/driver routines 

Hard Drive Low-Level interface/driver routines (optional) 
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IBMV-xx . Z80 
ICFG-xx . Z80 
IIO-XX.Z80 
RAMD-xx . Z80 
TIM-XX.Z80 
WBOOT-xx . Z80 


- Banking Support Routines (if banked) 

- Configuration file for speed, Physical Disks, 

- Character 10 definitions and routines 

- Ram Drive interface/dr iver routines (optional 

- Counter/Timer routines and ZSDOS Clock Driver 

- Warm Boot and re-ini t ial izat ion routines 


etc 

) 


3.3 B/P Bios Options. 

The most logical starting point in beginning a conf igurat ion is to edit the 
DEF-xx.LIB file to select your desired options. This file is the basic guide 
to choosing the options for your system, and some careful choices here will 
minimize the Bios size and maximize your functionality. Some of the more 
important options and a brief description of them are: 

MOVCPM - Integrate into MOVCPM "type" loader? If the system is to be in- 
tegrated into a MOVCPM system, the Environment descriptor contained in the 
CBOOT routine is always moved into position as part of the Cold Start process. 
If set to NO. a check will be made to see if an Environment Descriptor is 
already loaded, and the Bios copy will not be loaded if one is present. 

NOTE: When assembling a Bios for Boot Track Installation ( MOVCPM set to YEs ' . 
many options are deleted to conserve space and the Bios Version Number is 
forced to 1.1. 

BANKED - Is this a banked BIOS? if set to YES. the Bank control module. I BMW 
is included in the assembly, and much of the code is relocated o the system 
bank. Note that a Banked system CANNOT be placed on the System Tracks, or 
integrated into a MOVCPM image. 

IBMOVS - Are Direct Inter-Bank Moves possible? If set to YES. direct transfer 
of data between banks is possible such as with the Zilog ZlSO/Hitachi 64180. 
II NO. a 2o6-byte transfer buffer is included in high Common Memory and Inter- 
bank moves require transfer of bytes through this buffer. 

ZSDOS2 - Assemble this for a Banked ZSD0S2 system? If YES. the ALY and CSV 
buffers will be placed in the System bank invisible to normal programs. This 
has the side effect that many CP/M programs which perform sizing of files 
(Directory Listers, DATSWEEP, MEX, etc) which do not know about this function 
will report erroneous sizes. The advantage is that no sacrifice in TPA is 
required for large Hard Disks. Set this to NO if you want strict CP/M 2.2 
compat ibi 1 ity . 

FASTWB - Restore the Command Processor from the System Bank RAM? If set to 
YES, Warm Boots will restore the Command Processor from a reserved area in the 
System RAM bank rather than from the boot tracks. For the maximum benefit of 
B/P Bios, always attempt to set this to YES. In systems without extended 
memory, it MUST be set to NO. 

MHZ - Set to Processor Speed in closest even Megahertz (e.g. for a 9.216 Mil:: 
clock rate, set to 9). The value entered here is used in many systems to 
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compute Timing values and/or serial data rate parameters. 

CALCSK - Calculate Diskette Skew Table? If NO. a Skew table is used for each 
floppy format included in the image. Calculating Skew is generally more 
efficient from a size perspective, although slightly slower by factors which 
are so small as to be practically unmeasurable. 

HAVIOP - Include IOP code into Jump table? If the IOPINIT routine satisfies 
your IOP initialization requirements, you may turn this off by setting to NO 
and save a little space. This typically will be turned off when generating a 
system for MOVCPM integration to conserve space. 

INROM - Is the Alternate Bank in ROM? Set to NO for Normal Disk-based sys- 
tems. Please contact the authors if you need additional information concern- 
ing ROM-based system components. 

BIOERM - Print BIOS error messages? Set this to YES if you desire direct BIOS 
printing of Floppy Disk Error Messages. If you are building a BIOS for place- 
ment on Boot Tracks, however, you will probably not have room and must turn 
this Off. Set to NO to simply return the normal Success/Fail error flag with 
no Message printout. 

FL0PY8 - Include S" /Hi -Density Floppy Formats? Some systems (SB- ISO. 
Compu/Time) can handle both 5.25" and 8" disks. If your hardware supports the 
capability and you want use S" disks as well as the normal 3.5 and 5.25" 
diskettes, setting this to YES wi 1 i add formats contained in DPBS.LIB and 
control logic to the assembly. Future systems may take advantage of the 
"High-Density" 3.5 and 5.25" Floppy Disks which use higher data rates. Their 
definitions will be controlled by this flag as well. 

NOTE: If AUTOSL is set to NO. this option will probably cause the BIOS to be 
larger than necessary since these additional formats may not be accessible. 

MORDPB - Use more Floppy DPB's (in addition to normal 4-5.25" and optional 
S")? If YES. the file DPB2.LIB is included. Many of the formats are Dummies, 
and may be filled with any non-conflicting formats you desire. 

NOTE: If AUTOSL if set to NO. this option will probably cause the BIOS to be 
larger than necessary since these additional formats may not be accessible. 

MORDEV - Include Additional Character Device Drivers? Is set to YES. user- 
defined drivers are added to the Character 10 table, and associated driver 
code is assembled. Systems featuring expansion board such as the SB-1S0 and 
YASBEC may now take advantage of additional serial and parallel interfaces 
within the basic Bios. Set to NO to limit code to the basic 4 drivers. 

NOTE: When assembling a Bios for Boot Track Installation (MOVCPM set to YES). 
MORDEV is overridden to conserve space, and the Bios Version Number is forced 
to 1.1 in the distribution files. 

BUFCON - Use type ahead buffer for the Console? If set to YES. code is added 
to create and manage a type-ahead buffer for the driver assembled as the 


12 



B/P BIOS 


TAILORING 


console. This device will be controlled by either interrupts (in systems such 
as the YASBEC and SB-180) or background polling (in Ampro and Compu/Time). 
This means that characters typed while the computer is doing something else 
will not be lost, but will be held until requested. 

BUFAUX - Use type ahead buffer on Auxiliary Port? As with BUFCON above, set- 
ting to YES will add code to create and manage a type ahead buffer for the 
auxiliary device. Since the AUX port typically is used for Modem connections, 
buffering the input will minimize the loss of characters from the remote end. 

AUTOSL - Auto-select floppy formats? If set to YES, selection of Floppy disks 
will use an algorithm in SELFLP2.Z80 to identify the format of the disk from 
the DPB files included (DPB.LIB, optional DPBS.LIB, and optional DPB2.LIB) and 
log the disk if a match is found. There must be NO conflicting definitions 
included in the various files for this to function properly. See the notes in 
the various files to clarify the restrictions. If set to NO, the single file 
DPBRAM.L1B is included which may be tailored to contain only the fixed format 
or formats desired per disk drive. This results in the smallest code require- 
ment, but least flexibility. 

RAMDSK - Include code for a RAM-Disk? If set to YES, any memory above the 
System or User bank may be used for a RAM Drive (default is drive M: ) by 
including the file RAMD-xx . Z80 . Parameters to determine the size and configu- 
ration are also included in the files DPHM-xx.LIB and DPBM-xx.LIB. In systems 
without extended memory, or to conserve space such as when building a system 
for the boot tracks, this may be disabled by setting to NO. 

HARDDSK - Include SCSI Hard Disk Driver? Set to YES if you wish to include 
the ability to access Hard Disk Drives. In a floppy-only system, a NO entry 
will minimize BIOS code. 

HDINTS - (System Dependent) In some systems such as the YASBEC. Interrupt- 
driven Hard Disk Controllers using DMA transfer capabilities may be used. If 
you wish to use this type of driver specified in the file HARDI-.xx.Z80 instead 
of the normal polled routines included in HARD-xx . Z80 , set this option to 
TRUE. In most cases, this driver will require more Transient Program Area 
since the Interrupt Handling routine must be in Common Memory. 

CLOCK - Include ZSDOS Clock Driver Code? If set to YES. the vector at 
BIOS+4EH will contain a ZSDOS-compat ible clock driver with the physical code 
contained in the TIM-xx.ZSO module. If set to NO, calls to BIOS+4EH return an 
error code. 

TICTOC - (System Dependent) Use pseudo heartbeat counter? This feature is 
used in systems such as the Ampro Little Board and Compu/Time SBCS80 which do 
not have an Interrupt scheme to control a Real Time Clock. Instead, a series 
of traps are included in the code (Character 10 Status polls, Floppy Disk 
Status polls) to check for overflow of a 1-Second Counter. It is less desir- 
able than an Interrupt based system, but suffices when no other method is 
available. Set to NO if not needed. 

QSIZE - Size in bytes of type ahead buffers controlled by BUFCON and BUFAUX. 
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REFRSH - Act ivate Dynamic Refresh features of Z180/HD64180 processors'.' In 
some computers using these processors such as the YASBEC. refresh is not 
needed and merely slows down processing. Set to NO if you do not need this 
feature. If your processor uses dynamic memory, or needs the signal for other 
purposes (e.g. The SB1S0 uses Refresh for Floppy Disk DMA), Set this to YES. 

Z3 - Include ZCPR init code? Since a Z3 Environment is mandatory in a B/P 

Bios (which now "owns’’ the Environment), this option has little effect. 

For assembly of a Banked version of B/P Bios, the identification of various 
banks of memory must be made so that the various system components "know” 
where things are located. Refer to Section 3.1 above for a description of 

these areas. The BNKO value should be the first bank of RAM in the System 

unless other decoding is done. The following equates must be set: 

BNKO - First 32k TPA Bank (switched in/out) 

BNK1 - Second 32k TPA Bank (Common Bank) 

BNK2 - Beginning of System Bank (BIOS. DOS. CPR) area 

BNKU - Beginning of Bank sequence for User Applications 

BNK3 - Beginning of Extra Banks (first bank to use for RAM Disk) 

BNKM - Maximum Bank Number assigned 


3.4 Configuration Considerations. 

When assembling a version of B/P Bios for integration into an IMP file, size 
of the resulting image is not much of a concern, so you need not worry about 
minor issues of size. For integration into a system for loading onto diskette 
boot tracks, however, the limitation is very real in order to insure that the 
CPR/DOS/BIOS and Boot Sector(s) can fit on the reserved system tracks. Typi- 
cally. a limit of slightly under 4.5k exists for the Bios component . When the 
MOVCPM flag is set to YES for this type of assembly, warnings will be issued 
when the image exceeds 4352 bytes (the maximum for systems with 2 boot 
records), and 4480 bytes (the maximum for systems with a single boot record ! . 
Achieving these limits often requires disabling many of the features. 

The first thing you should do before assembling the BIOS is to back up the 
entire disk, then copy only the necessary files onto a work disk for any 
editing. After setting the options as desired, edit the hardware definitions 
in ICFG-xx.ZSO to reflect the physical characteristics of your floppy and hard 
drives, as well as any other pertinent items. Then edit the logical charac- 
teristics for your Hard and Ram Drives (if any) in DPBHD-xx.LIB and DPBM- 
xx. LIB. If you do not desire any of the standard floppy formats or want to 
change them, edit DPB.LIB and/or DPB2.LIB (if using auto selection) or 
DPBRAM.LIB if you are using fixed floppy formats. Finally edit the DPH files 
to place the logical drives where desired in the range A. .P. 

Decide whether you want to generate a system using the Image file construct 
developed in support of B/P Bios (BPBUILD/LDSYS ) . or for integration on a 
floppy disk's boot tracks. If the latter, you probably will not be able to 
have all options turned on. For example, with the MicroMint SB-180, the 
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following options must be turned Off: BANTCED. ZSD0S2 , BIOERM. FLOPYS, MORDPB. 
BUFAUX and usually either CLOCK or RAMDSK. As an aid to space reduction, 
conditional assembly based on the MOVCPM flag automatically inhibits all but 
double-sided Floppy formats from DPB.LIB. If configuring for Floppy Boot 
tracks (MOVCPM flag set to TRUE), a warning will be printed during assembly if 
the size exceeds that available for a One or Two-sector boot record. Using 
the BPBUILD/LDSYS method, you may vary nearly all system parameters, even 
making different systems for later dynamic loading. 

If you are using a version of the B/P Bios already set for your type of com- 
puter, you are now ready to assemble, build a system and execute it. The only 
remaining task would be an optional tailoring of the sign on banner in the 
file CBOOT-xx.ZSO and reassembly to a .REL file. 

For those converting a standard version of the B/P Bios to a new hardware 
system, we recommend that you begin with a Floppy-only system in Non-Bank ed 
mode then expand from there. The easiest way to test out new versions is to 
use the System Image (IMG file) mode, then advance to boot track installations 
if that is desired. Enhancements that can be added after testing previous 
versions may be to add Hard Drives. RAM Drive, and finally Banking. 
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4 Installing a B/P Bios. 

The Distribution diskette(s) on which B/P Bios is furnished are configured for 
booting from the vanilla hardware for the version ordered. A 9600 bps serial 
terminal is standard, and will allow you to immediately bring up a minimal 
non-banked floppy disk system. Due to the variety of different system config- 
urations and size restrictions in some versions, only the Floppy Disk Mass 
Storage capability can be assured on the initial boot disk. Where space 
remained on the boot tracks, limited Hard Drive support is also provided, and 
in some configurations, even RAM Drive support exists. 

After booting from either an established system, or the boot tracks of the 
distribution disk, format one or more fresh diskettes and copy the distribu- 
tion diskette! s) contents to the backup diskette(s). Copy the boot tracks 
from the master to the copies using BPSYSGEN (see 6.6). Remove the master 
diskette(s) for safekeeping and work only with the copies you just made. 

Using the backup diskette with the B/P utilities on it. execute BPCNFG in the 
Boot Track configuration mode (see 6.2), adjusting all the options to your 
specific operating environment. When you have completed tailoring the system, 
it is ready for booting by placing the diskette in drive A: and resetting the 
sys t em . 


The sample STARTUP . COM file on the distribution disk will automatically exec- 
ute a sequence of instructions when the system is booted. It contains various 
instructions which further tailor the system and load portions of the operat- 
ing system which are too big to fit on the boot tracks. The default instruc- 
tion sequence is: 


LDDS 

LDR SYS . RCP , SYS . FCP , SYS . NDR 

IOPINIT 
TD S 

IF ~EX MYTERM.Z3T 
TCSELECT MYTERM.Z3T 
FI 

LDR MYTERM . Z3T 

If you wish to alter any of these 


< — Load the DateStamper style File 
Stamp routine and clock 
< — Load ZOPK 3 Environment segments 
for Resident Command Processor. 
Flow Control Pkg and Named Dirs 
< — Initialize the 10 Processor Pkg 
< — Prompt, for Date and Time, Set Ok 
Alternatives are to use TDD 
(6.21) or SETCLOK (6.18) 

<— If the file MYTERM. Z3 1 does Not 
exist .. . 

< — ..select which terminal you have 
crea 1 1 ng a MYTERM . Z3T file 
< — . . .end of the IF 
< — Load the Terminal Definition data 

instructions to, for example, ini- 
Time Stamp capabilities to it 
with COPY, these may be added 
files available from the ZSYS- 


initial 

tialize the RAM drive using INIRAMD, add File 
with IN1TDIR or PUTDS and copy some files there 
with ALIAS. VAL IAS. SAL 1 AS or other compatible 
TLM or ZCPR33 areas on Z-Nodes. 
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After the initial system is up and running from the Default Boot Track system, 
you may expand the operation by generating systems for different purposes in 
order to gain the most advantage from your system. Many types of installation 
are possible, the simplest of which is a Non-Banked system using only (>4k of 
the systems memory, ail of which is in primary memory. Such a system uses a 
normal Command Processor such as the ZCPK3 . x family, and a Non-Banked Operat- 
ing System such as our ZSDOS Version 1. Non-Banked systems may be installed 
on a Disk's Boot Tracks, or created as an Image File for dynamic loading using 
the LDSYS Utility (see P.15). 

Banked systems MUST be created with the BPBUILD Utility (see 6.1) and loaded 
with LDSYS (see 6.15). The techniques to manage different memory banks To 
form a complete Operating Environment are rather intricate and are best han- 
dled by our utilities. Many Image files may be created and loaded as needed 
to tailor your system for optimum performance. The following sections de- 
scribe these various types of installations in detail. 


4.1 Boot 1 rack installation. 

lor most of t he existing CP At compatible computers to begin execut ini a Disk 
Operating System, a program must Pe placed on a specified area of a t- ! oppv or 
Hard D i 1 Drive. Normal :y. the first two or three tracks, on the disk, are 
reserved for this purpose and are referred to as the "Boot Tracks' . since tin. 
space' so defined is genera ! 1 y restricted, neither a complete B/P bios not a 
Hanked in -uni i at io.i is possible . Instead, a scaled-down system rough 1 y equiv- 
alent to those currently m use is used to start the computer ana serve ; the 
Operating system, with larger systems loaded later as needed. 

If you are using a pre-coni i cured version of B/P bios, for you r haruwar . y. a 
may sin. ply continue tr use the Boot Track system from the distribution disk is ; 
by copying the .system as describee in Section 4 above using BPSiSGFN is., 
b • b ■’ • 1 * e i ect to alter or otherwise customize the Boot Track system, you 

must assemble the li/t I ios source setting certain of the equates in the DF.l - 
xx. rU file t ... insure a correct type of system. To assemble a Boot Tiack 


most important 

equa t e ■ 

a n r 0 I 

MOVCPM 

Set 

to 

YES 

BANKED 

Set 

to 

NO 

ZSD0S2 

Set 

to 

NO 


One element of Banked Systems is available in a Boot Track installation il 
additional memory is available, and your B/P Bios routines support such a 
feature. This feature reloads the Command Processor from Banked memory in- 
stead of Irom the Boot Tracks of a disk, and generally produces less cork 
(taking less space on the boot Tracks) and executes faster. It is set with: 

Set to YES if desired. NO if Warm hoot from disk 


FASTWB 
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Some of the features that generally need to be disabled to scale a smaller 
system are set as: 

MORDPB Set to NO 
DPB8 Set to NO 
MORDEV Set to NO 


When at least these equates and any others you desire to change (see section 
4) have been made to the component files of the system, assemble your BPBIO-xx 
file to a Microsoft standard REL file. This output file may be used to over- 
lay the Bios portion of the MOVxSYS.COM system generation utility (see 6.16) 
furnished with vour distribution disk, or an equivalent program provided with 
your computer. MOVxSYS or its equivalent (MOVCPM, MOVZSYS . etc) is a special 
program customized for your particular hardware containing all the Operating 
System components which will be placed on the Boot Tracks, along with a rou- 
tine to alter the internal addresses to correspond to a specified memory size. 

To Add the ne" Bios you just assembled, execute INSTAL12 (see procedures in 
6.13) specifying your computer’s MOVxSYS or equivalent program and follow the 
prompts to overlay the new Bios. Once INSTALL* has saved a relocatable or 
absolute file, you are read;, to create n boot disk containing the modified 
system . 

It you used the command INSTAL12 to install system segment s on MOYxSYs o: 
equivalent program, you must first create an Absolute System Model file. 
Since the functional portion of you r new program is ; dent i ca ; to the original 
MON 'x SYS or equivalent . use the method explained in you: original document at ion 
to generate a new system. With M( A'xsVS . the command is: 

MOVxSYS nn * < — replace MOYxSNS with you r version 

vhe re nn is the size- of the system ( typica l iy 51 ioj a moderate boot system) . 
The asterisk tei !> the prc-cran. to retain the image in memory and not write it 
to a disk file. You may noa u: ■„ BPSYSGfY to write the new imago to the system 
tracks of vour boot diskette . uo this, by executing BPSYSGi.N with no arguments 
and issue a single Carr tag-. Return when asked for the* source of the J mage . 

If you usee the command INSTAL12 /A to install replacement system segment: 
over a System Image file, or used a utility which wrote the new image to a 
disk file, use BPSYSGEN to write the image file to the system tracks of your 
boot disk. The proper command is 

BPSYSGEN f i 1 ename 


where filename is the name of the disk file you just created by executing 
MOVxSYS or equivalent with output to a disk file, or with INST AT 1 2 on an 
existing image file. 

If the system is written to a Hard bisk, and your system supports booting from 
a Hard Disk such as the YASBiT . you normally must alter the default Boot 
Sector from the default F ( oppy Disk Boot Sector contained in MOVxSYS or equiv- 
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alent. This alteration is accomplished by HDBOOT (see 6.9) which must be 
customized to the specific Hardware System used. 

After the above actions have been completed as appropriate, tailor the Boot 
Track system to reflect the desired starting configurations with BPCNFG (see 
6.2). Such items as the desired Startup file name. Bank Numbers (critical if 
FAST'WB is used), and drive types and assignments are routinely tailored at 
this point. When the you have finished this step, test your new system by 
resetting the system, or cycling the power and you should be up and running! 


4.2 Non-Ban ked Image Installation. 

A Non-Banked system may be installed as an Image File as opposed to the basic 
Boot Track installation covered in 4.1 above. To create an Image File, you 
must have RU. or ZKL versions of a Command Processor (ZCPR3.X or equivalent 
recommended), an Operating (ZSDOS.ZRL recommended), and a RLL version of b/P 
Btos for your system assembled with the MOVCPM equate in DEF-xx.LIfa set to NO. 
Other equates in this file may be set as described above lor the Boot Track 
system. Since Image files are not as constrained in size as is installation 
for Boot Tracks, more features may generally be activated such as F,rror Mes- 
sages. RAM Drive, additional Hard Drive partitions, and complete floppy Format 
suites. The main precaution here is that large Hard Drives will rapidly cause 
significant loss of Transient Program Area since all Drive parameters must be 
in protected high memory above the Bios. 

After the Bios has been assembled, an image file must be produced . This is 
accomni ished t h the bPBliLD 'utility ( see 6.1). Set the File names in Mem; .1 
to reflect only Non-banked flies (or minimally banked Bios if FASTWB is set in 
YES ) . and let BPBLILD do the work . since the standard Non-banked .System- 
segments are normal iy set to the ' standard” CP/M 2.2 sizes, you may answer the 
‘ autosize' query with a Y to obtain the maximum Transient Program Area in the 
resulting system. When BPBbll.D completes its work, a file, normally with the 
default type oi .IMG. will have been placed in the currently logged Drive/User 
area and you are ready to perform the next step in preparation of the Non- 
banked image. 

As with the Boot Track installation covered above, several system items must 
be tailored before the Image may be safely loaded and executed. This is done 
by calling BPCNFG with the Image file name as an argument, or specify Image 
conf i gurat i on from the interactive menu (see 6.2). Set all items as you 
desire them in the operating system, particularly the Bank Numbers (if PASTA it 
is active), and the Disk Drive characteristics and assignments. When this has 
been satisfactorily completed, you are ready to load and execute the newly- 
created system. 

Installing an Image File (default file type of .IMG) is extremely easv. Onlv 
the utility LDSVS.COM (see 6.15) is needed. If the file type has not been 
changed from the default . IMG, only the basic name of the Image File need be 
passed to LPSYS when executed as: 

LDSYS IMGFILE < — Where IMGFTLF is vour Image file name 
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The operating parameters of the currently-executing system are first examined 
for suitability of loading the Image File. If it is possible to proceed, the 
Image File is loaded, placed in the proper memory locations, and commanded to 
begin execution by calling the B/P bios Cold Boot Vector. The Cold Boot 
(Bios Function 0) performs final installation, displays any desired opening 
prompt and transfers control to the Command Processor with any specified 
Startup file for use by a ZCPRJ.x Command Processor Replacement. 

Since a non-banked Image File will probably closely resemble that contained on 
the Boot Tracks, the same STARTUP file may generally be used to complete the 
initial tailoring sequence. If a different file is desired, the Image File 
may be altered to specify a different file using BPCNFG. 


4.3 Banked Bios, Non-banked System Installation. 

Vvith the B/P Bios system, an Image system may be created and loaded which 
places portions of the Bios Only in the System bank, retaining a non-banked 
Operating System and therefore maximum compatibility with existing applica- 
tions software. A few thousand bytes can normally be reclaimed for Transient 
Programs in this manner, although large and/or increasing numbers of logical 
drives will still reduce TP A space because of the need to store Allocation 
Vector information in Common Memory. 


To prepare 

such a s; 

vs tern, simp Ir- 

eri it the 

needed bios file s j f n e ces s a i • • wit; • 

part icular 

emphas i s 

on the DBF -xx 

.1.11 

j fil 

e where the following equates must be 

set as; 

MOVCPM 

Set 

to 

NO 



BANKED 

bet 

to 

YES 



ZSD0S2 

Set 

to 

NO 


Since bank 

eel me more 

M/5 7 be avail 

an i i 

o 1 OJ 

- this typ. of installation, you will 

probably want the F. 

a st Warn, boot 

tea 

lure 

available to maximize system per for- 

mance. To 

cl C t. ! \ ci v v' 

this option. 

set 

the 

following equate as: 


FASTWB 

Set 

to 

YES 



When the editing is complete, assemble the Bios to a Microsoft . REL file with 
an appropriate assembler such as ZMAC and build an image system with BPBU1LU 
(see 6.1) changing the Bios file name in menu 1 to the name of the newly 
created Bios file. Next, configure the default conditions if necessary with 
BPCNFG (see 6.2 > and you are ready to activate the new system in the same 
manner as ail Image files by calling LDSYS with the Image file argument as: 

LDSYS BBSYS < — where BBSYS is your Image File Name 

As with the completely Non-banked system described above in Section 4.2. no 
new requirements are established for a Startup file over that used for the 
initial Boot System, since both the Command Processor and Disk Operatise 
System are unbanked . and no data areas needed by application programs are 
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placed in the System Bank. As with aii image Files, additional features such 
as lull bios Error Messages, more extensive F loppy Disk formats and RAM drive 
may generally he included in the System definition prior to assembly since the 
size constraints of Boor Track systems do not apply. 


4.4 Fully Banked Image Installation. 

To create a system taking maximum advantage of banked memory, a special banked 
Operating System and Command Processor are needed. These have been furnished 
in initial form with this package as ZSDOS20.ZRL and Z40.ZRL respectively. 
They use the banking features of B/P Bios and locate the maximum practicable 
amount of executable code and data in the System Bank. Of significant impor- 
tance to maximizing the Transient Program Area is that the Drive Allocation 
hit maps are placed in the System Bank meaning that adding large hard drives, 
or multiple drives produce only minimal expansion to the resident portion of 
the Bios. 


A Fully banked Bios is created by editing the B/P Bios files as needed to 
customize the system to vour desires. Insure that the following DEF-xx.LlB 
equates art set as: 

MOVCPM Set to NO 

BANKED Set to YES 

ZSD0S2 set to )ES 

Assemble the resultant B/ iJ Hies to a Microsoft . RIM, file. Bui id an Image f i le 
with BPBLILD (see 6 . 1 • and coni'- " re the produced Image file with RPCNfu (see 
6.2). When you are coni idert that ail default settings have been made . acti- 
vate the file by entering: 


LDSYS FBANKSYS < — where F BANKS VS is your image file name 


Several differences may exist in the Startup file used for a Fully banked 
system. General Iv the changes amount to deleting items such as a File Stamp 
module i or the Non-bank ed 2SD0SJ which is not necessary with the tullv-banked 
ZSix.'S 2 and 7 40. On i y the type of clock need he specified for ZS!x)s2. Hn- 
thermore. since the Z40 Command Processor Replacement contains most common 1 v- 
used command s gathered from a number of Resident Command Processor ( POP ) 
packages, there is normally no need to load an RCP. A simple Startup file 
found adequate during development of the fully-banked B/P system is: 


ZSCFG2 CB <— 

LDR SYS . FCP , SYS . NDR <— 

IOPINIT <— 

TD S <— 

IF ~EX MYTERM.Z3T <— 

TCSELECT MYTERM.Z3T <— 


Set ZSDOS 2 clock to Bios+4F.H 
Load ZCPR 3 Environment segments: 
for Flow' Control and Named Dirs 
Initialize the 10 Processor Pkg 
Prompt for Date and Time. Set Clk 
Alternatives are to use TDD 
(6.21) or SETCLOk (6.18) 

If the file MYTERM.Z3T does Not 
exist .. . 

..select which terminal you have 
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creating a MYTF.KM.Z.T1 file 

FI < — ... end if the I i 

LDR MYTERM.Z3T < — Load the Terminal Definition data 

Since the requirements for a fully-banked system differ significantly from a 
non-banked one, we recommend that you use a different name for the Startup 
file. For example, STARTUF.COM is the default name used with Boot Track 
systems for initial operation, and with Non-banked Image Files, while STARTB 
may be a suitable name for the script to be executed upon loading a fully- 
banked system. The name of the desired Startup file may be easily altered in 
either Boot Track or Image systems from Option 1 in BPCNFG (see 6,2). 

An option available to start from a large Image File is to configure a Startup 
file for execution by the Boot Track system containing a single command. The 
command would simply invoke LDSYS with the desired Banked Image File as an 
argument such as: 

LDSYS BANKSYS < — Where BANK.SYS.lMo is your image tile 

In this case, none of the norma! initialization sequences cited above would be 
executed by the Boot Track system, and only those contained in the Startup for 
BANKSYS . IMG would occur. Other options abound and are left to the community 
to invent new combinations ana sequences. 


4.5 in Case of Problems... 

While Wo attempted to out line procedures f r T he majority of installations wc 
considered feasible, there may be occasions where you inadvert ent i v find 
yourself in a posit ion wnere von seem to have lost the ability to set your 
system up and running . 

PROBLEM: When ioadine an . IMg file with LDSYS. the screen displays the U.'svs 

banner, system aodress.es, and halts with the last screen displaying: 

. . . loading banked system . 

SOLUTION Something is not set correctly in the Bios, since ai 1 line: 
after the last one displayed are printed from the newly-loaded bios. one of 
the most common causes tor this problem is incorrect bank number settings. 
Use the hidden selection in Menu 1 of BPCNFG (see 6.2) to verify that the 
correct bank numbers have been set for TPA and SYStem banks. Another common 
cause of this problem is incorrect settings for the Console port, or a setting 
in the I0BYTF. which directs Console data to a device other than the one in- 
tended. Use Menu 2 BPCNFG to properly set the fORYTE and the console parame- 
ters . 

PROBLEM: You boot from or load a B/P Bios system from a Hard Drive, and 

immediately after starting, the system attempts to log onto Floppy Drive 0. 

— SOLUTION: The most common cause for thus symptom is that the desired 

Hard Drive and Floppy Drive definitions were not swapped to define a Kara 
Drive Partition as the A: drive. D-se BPCNFG (see 6.2) , Menu f to exchange 
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drives to the desired configuration. A similar situation may exist where a 
Hard Drive is activated immediately alter booting when a floppy drive is 
desired as the A: Drive. 

PROBLEM: The computer seems to boot satisfactorily, but after a few programs 
or any program which executes a Warm Boot (or entering Control-C), the system 
goes into "Never-never Land" and must be reset . 

— SOLUTION: This symptom is most often caused by an inability to access 
and load the Command Processor. This is most probably caused by assembling 
B/P Bios with the FASTWB equate in DEF-xx.LIB set to YES when the system 
contains no extended memory, or incorrect settings of the Bank Numbers. To 
check Bank Number settings, use the hidden function in BPCNFG, Menu 1 (see 
6 . 2 ). 


PROBLEM: When doing a Cold Boot from a Hard Drive (from Power up or Reset), 
the system goes to a floppy Drive before displaying the initial sign on mes- 
sages, and remains logged on the Floppy. 

SOLUTION: This is most often due to your forgetting to run the HDB(X); 
utility on the Hard Drive Boot system alter applying it with BPSYSGEN . Nor- 
mally. systems created with MOVxSYS contain a floppy Disk Boot sector which 
will load the initial Operating System Iron 1 a Floppy. HDBOOT (see t>.9) mod 1 - 
lies this record on a specified Hard Drive Unit so that the Operating System 
is loaded 1 rom a Hare Drive. Run HDBOOT on the Desired Hard Drive, then use 
BPCNFG (see t> . 2 ) to insure that the logical drives are positioned as desired 
(Menu 5). 

PROBLEM: When Boot i ng . the system console either doesn’t display anything, or 
prints strange characters . 

SOLUTION: This is most otten due to incorrect settings for the current 
Console, most probably the Data rate, or CPU Clock Frequency. boot from a 
good system, then use BPCNFG (see 6.2) to adjust the settings on the problem 
system. Pay particular attention to Menu 1 ( CPU clock Rate) and Menu 2 
(IOBY'i't and Serial Port Data Rates). 

PROBLEM: when running a fully-banked system with ZSDOS 2. some programs seem 
to "hang 1 or "lock up’ the system on exit. 

SOLUTION: One of the most common sources of this symptom is with the 
application program where the author used code w’hich assumes that the BDOs and 
Command Processor are ol a certain size, or bear a fixed relationship to the 
addresses in page 0. You may experience this most often when using an IMG 
system built by answering YES to the Autosizmg query in BPBU1LD (see 6.1). 
To compensate lor such ill-behaved programs, you may use a two-step build 
process as: 

1) Use BPBUILD to create an IMG file answering YES to Autosizing on exit. 
This maximizes TPA placing the Resident Bios as high as possible in memory. 

_) Execute BPBUILD again with an argument of the name you gave to the- tile 
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just created above. This loads the dei in it ion from the IMG file. immediately 
exit with a carriage Return, and answer NO to Autosizing, and YES to placing 
system segments at standard locations. This procedure keeps the Bios address 
constant, but will move the starting addresses of BOOS and Command Processor 
down, if possible, to simulate 'standard" sizes used in CP/M 1.2. 
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5. Programming for B/P Bios. 

For most existing purposes, programming for B/P Bios is no different than for 
standard C'P/M 2.2 BIOSes . Even adapting CP/M 3 programs for a B/P Bios should 
present no great hurdle due to the close similarity retained with the corre- 
sponding extended functions. The power of a B/P Bios interface, however, is 
in using the combined features to produce portable software across a wide 
variety of hardware platforms by exercising all of the B/P Bios features in 
concert. This section describes the interfaces available to the programmer of 
a system using the B/P Bios, and the functions available to ease direct floppy 
and hard drive accesses for specialized programming in a consistent manner. 

One of the architectural flaws which we considered in CP/M Plus was the odd 
way in which direct BIOS access was handled. We designed B/P Bios to be as 
compatible with CP/M 2.2 as possible, yet provide the expanded functionality 
needed in Banked applications. To that end, direct interlace with BIOS cal is 
follows CP/M 2.2 conventions as much as possible. 

The following pages on programming assume some familiarity with the basic CP/M 
fundamentals, and with Z80/ZJS0 assembly language, since it is beyond the 
intent of this manual, and our literary writing skills, to present an assembly 
programming tutorial. Should you need additional assistance in this area, 
please refer to the annotated bibliography for reference material. 


5.1 Bios Jump Table. 

The BIOS Jump table consists of 40 Jumps to various functions within t 1 ■ Blob 
and provides t he basic f unct ional i ty . It includes the complete CP/M 2.2 
sequence . most of the CP/M 3 (ana CP/M Plus ) entry points (although some 
differ in parameter ordering and/or register usage.), and new entry points 
needed to handle banking in a consistent and logical manner. 

Bios entry points consist of a Table of Absolute 3-byte jumps placed at the 
beginning of the executable Image. Parameters are passed to the Bios in 
registers as needed for the specific operation. To avoid future compatibility 
problems, some of the ground rules for Bios construction include: No 
alteration of Alternate or Index registers as a result of bios calls, and all 
registers listed in the documentation as being Preservea/bnaf fee t eci Midi b>. 
returned to the calling program in their entry state. Bios entry points are: 


| Function 0 (xxOO) 

1 ... . . 


Cold Boot j 

1 

j - — ■ ■ *■ 

j truer: None 

1 

i 

r 

Exit: 

1 

None . j 

Execution resumes at CPR 

i 

1 

l l r — 

1 Uses: 
l 

AM Registers 


Execute void start initialization on the first execution. The jump argument 
is later overwritten, and points to the 10P Device jump table. The reason for 
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this is that code to perform the initialization is often placed in areas of 
memory which are later used to store system information as a memory conserva- 
tion measure. Attempts to re-execute the initialization code would then 
encounter data bytes instead of executable instructions, and the system would 
most assuredly "crash'. 

Among other functions performed during initial execution of the Cold Boot cone 
are: Establishing an initial Z3 Environment if necessary, initializing any Z 3 
system segments such as an Extended Path. Flow Control Package, Named Direc- 
tory Buffer and such: setting system-specific values such as the locations of 
Allocation Vector buffers for RAM and Hard Drives: and executing the Device 
Initialization routine (see Function 21). The Cold Boot routine usually exits 
bv chaining to the Warm Boot Function ( function 1) to set vectors on Page 0 of 
the TPA memory bank. 


| ■ ‘ "■ 1 1 ! 

} Function 1 (x;<03) Warm Boot | 

- - - -- - - -- - — --- - - -- - — - - - - -- -- - - ! 

1/ — 

! Enter: None 

! 

il 

1 

i 1 i 

i Exit: None. I 

! Execution returns to CPR j 

! i 

1 Uses: AM Registers ; 

j 


This function re- initial izes t he Ope rat inp system and returns to the Command 
Processor alter reloading it from the default drive bool tracks, or Funked 
memory M t he Bios was assembled with th. Fast Warm hoot option. 

Unless altered by an i ] 1 -behaved Resident System Extension (KSXi or ot tier 
operating transient program, the Warm hoot Vector at location 0 in memory 
points to this vector, v.e ! j -behaved prog rams wi i i not alter this address but 
should, instead . alter tin. destination argument oi the Jump vector in the hios 
header. There is a singular except ion to this in the case of N7.COM where the 
Warm Boot recto ■ point? to the NZ.nl os. and Not the 'Real' Bios. in such a 
case . the aoaress of the "Kea ! bios must i>e separately determined ( Sec 1 un. - 
tiori 30'!. 


r ' ■ - - ' ' " " ' " 

1 Function 2 (xx06) 

1 

Console Input Status j 

- - . J 

! Enter: None 

1 Exit: A = OFFH it Char Ready, NZ 


i A = 0 i f No Cnar Ready , Z j 

S 

‘ 

j I 

j Uses: AF I 

i ... - - ... .. . - - . .... ... i 


This function returns a lias indicating whether or not a character has been 
entered from the Console device selected by the I GBYTE, on Page 0 of the T! 
bank. The return status is often used by Transient Programs to determine il 
the user has attempted to start or stop- program execution. 
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j Function 3 

i 

( xx 09 i 



Ji 

Console Input 1 

.. _ .... 1/ 

| Enter: None 
1 


j Exit: 

A = 

Masked Input Character j 

I 

i 


i Uses: 

L_ 

AF 

j 

_ ii 


This function waits for a character to be entered from the Console device 
selected by the I GBYTE on Page 0 of the TPA Bank, and returns it to the call- 
ing routine. According to strict CP/M 2.2 standards, the Most Significant bit 
of the input byte must be set to Zero, but this may be altered by the input 
mask for the Console Device. 


i 

Function 4 (xxOC) 




Console Out out ji 

i — 

i! 

Enter: C = Character to send to 

- lf“ 

i! 

Exit: 

None . 

ji 

Ii 

Console 

ii 



ii 

ii 


ii 

Uses : 

AF 

ii 

iL= 

. .. __ . 

ii 



_ ... 


This function sends a specified character to the Console Device del mecl by the 
IOBYTi on Page 0 (■! the TPA Bank. It will wait for the device to become 
ready . if necessary. !>. fei c sending the character . and will mask bus at 
specifier; j.n the character Device font i duration tor the dev j c e as an Output . 


| Function 5 ( x:<GF ) List Output 


jj Enter: C - Character to send to j: Exit: None. 

j! List Dev (Printer) jl 

j! I! Uses : AF 


This function will send a specified character to the List Device (Printer i 
defined by the ] GBYTE on Page 0 of the TPA Bank. It will wait for the device 
to become ready, if necessary, before sending the character, and will mask it 
as specified in the Character Device Configuration for the Output device. 
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1 — 

- ~ ■■ — i 

j Function 6 (xx12) 

Auxi 1 lary Output j 

- 1 

r — ■■ i 

Enter: C = Character to send to | 

- - --j 

Exit: None. i 

Auxi 1 lary Device j 


| 

Uses: AF 

1 K ! 


This function will send a specified character to the Auxiliary Output Device 
defined by the IOBVTE on Page 0 of the TPA Bank. It will wait for the device 
to become ready, if necessary, before sending the character, and will mask it 
as specified in the Character Device Configuration for the Output device. 


IP 

| Function 7 


( Enter: None 

j 

l B 


h 

(xx15) Auxiliary Input ( 


j! Exit: A = Masked Input Character I 

I 1 

j| Uses: AF j 

jl _ .. 


This function will read a character from the Auxiliary Input Device defined by 
the IOBYT) on Page 0 of the TPA Bank. It will wait for a character to be 
received, and will mask it as specified in the Character Device Configuration 
for t he 1 npu t dev ice. 


( 

i 

t 

S 

Function £ (xxIBl 




Home Drive 



1 

l 



V 



| 

i 

Enter: None 



Exit: 

None, heads on selected 


i 



! 


drive moved to Track 0. 


1 


- - 

i 

i — 

Uses : 

A1 1 Primary Registers 

j 


This function will position the head(s) on the selected drive to Track 0. In 
B/P Bios, This operation performs no useful action, and is simply a Return. 
Pending Write purges and head repositioning is handled by the individual 
device drivers (Specifically Select Drive functions). 
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( p= — 1 

i Function 9 (xxlB) Select Logical Drive | 

i — — - — — — — — 3 

f 

j Enter: C = Desired Drive 
j ( A=0 . . P= f 5 j 

i 

2. - - --- - - 

i i 

j Exit: (Success) A <> 0, NZ 

| HL = DPH Address 

; (No Drive) A = 0, Zero (Z) 

HL = 0 

i Uses: All Primary Reaisters 
1 ' . . ~ ... - .. J 


This function selects a specified logical drive as the current drive to which 
disk operations refer. If the operation is successful, the Disk Parameter 
Header (DPH) address is returned for later determination of the unit parame- 
ters If the operation fails for any reason ( non-ex istant drive, unknown or 
bad media, etc), a Zero value pointer is returned to signify that the drivt 
cannot be accessed through the bios. 


I Function 10 U/.1E ) Select Track I 

jj— __Hj 

|l Enter: BC - Desiree 1 rack Number is Exit: None. Track Number saved jl 

I |i ii 

i Uses: No Registers j! 


This function stores a specified i.ogical Track number for a future disk opera- 
tion. The last value stored with this function win he the one used in Disk 
Reads and Writes. 

NOTE: While a i 6-bit vaiue is specified for this function, on i y the lower hyt c 
(8-bitsj i s used in most drivers . 


|r= 


Function 1 1 (xxPl) 


ij Enter: BC = Desired Sector Num 


Select Sector 


Exit: None. Sector Numoer saved jj 


Uses: No Registers 


Phis function stores a specified Logical Sector Number for a future disk 
operation. The last value stored with this function will be the one used in 
Disk Reads and writes. 


NOTE: While a 16-bit vaiue is specified for this function, only the lower byte 
(8-bits) is used in all floppy Disk and most Hard and RAM Disk drivers. 
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i Function 12 (xx2 4) 

■ - ^ 

Set DMA Address for Transfer 

i 

Enter: BC - Buffer Starting Adar 

r~ * — — 

Exit: None. DMA Address saved 


Uses: No Registers 
— 


This Function stores a specified address to be used as the Source/Destination 
for a future disk operation. The last value stored with this function will be 
the one used in Disk Reads and Writes. In banked systems, the Bank selected 
for the transfer may be altered by Function 28. 


! 

! Function 13 (xx2?) 

•i . 



Disk Read j 

l) 

i Enter: None 

i 


I Exit: 
| Uses: 

l_ 

A = 0, Z i f No Errors 
A ~ Non-Zero it Errors, NZ 
All Primary Registers 

i- 


This function reads a Topical 128- byte sector from the Disk. Track and Sector 
set by Functions 9- i 1 to the address set with Function 32. On return. Reg- 
ister A=0 if the operation was successful. Non-Zero if Triors occurred. 


ll 

| 

Function 

1 4 

S xx2A ) 



Disk Write i 

1 r 

ii 

Enter: C = 

1 

for immediate write I 

Exit : 

A - 

0, Z if No Errors 

f 

C = 

0 

tor butterea write j 


A -- 

Non-Zero it Errors. NZ 

1 



! 

I Uses: 

A I 1 

Primary Registers 


This function writes a logical 128-byte sector to the Disk. Track ana Sector 
set by Functions d-li from the address set with Function 12. If Register (=1. 
an immediate write and flush of the Bios buffer is performed. If C-0. the 
write may be delayed due to the deblocking. 


1; - ■ - — ■ = 

| Function 15 (xx2D) 

List Output Status j: 

ii 

| Enter: None 

; .. _ . .... .... ... . ■ y 

| Exit: A = OFFH, NZ if ready tor i 

1 

Output Character 

i 

A = 0, Z it Printer Busy j 

i 

j Uses: AF 


This function returns a flag indicating whether or not tne printer is ready to 
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accept a character. It uses the KBYTE on Page 0 of the TPA Bank to determine 
which physical device to access. 


J Function 16 (xx30) 



Perform Sector Translation j 

i Enter: BC = Logical Sector Num 

~\ 

Exit: HL = Physical Sector Num I 

I DE = Addr of Trans Table 

j 

1 

ii 

Uses: All Primary Registers j 

- 11 


This function translates the Logical Sector Number in register BC (Only C used 
at present! to a Physical Sector number using the Translation Table obtained 
from the DPI! and addressed by DL. 

This ends the strict CP/M 2. 2-comp li ant portion of the Bios Jump Table. The 
next series of entry Jumps roughly follows those used in CP/M 3. but with 
corrections to what we perceived to be deficiencies and inconsistencies in the 
calling parameters and structures. 


Function 17 (xx33) 


Enter: None 


Exit: 


Uses 


Console Output Status 


A = OFFH, NZ if Console ji 
Ready for output char ij 
A = 0. Z it Console Busy j! 


This function returns a flag indicating whether or not the Console Device se- 
lected by the KBYTE on Page 0 or the TPA Bank is ready to accept another 
output character. 


1 Function IS (xx3G) Auxiliary Input Status j 

IL _ .... . ' 

II 

|| Enter: None 

j 

l 

i " 1 

I Exit: A = OFFH, NZ if Aux Input 
i has character waiting 

A = 0, Z it No char ready 
Uses: AF 

i 


This function returns a flag indicating whether or not the Auxiliary Input 
selected by the KBYTE on Page 0 of the TPA Bank has a character waiting. 
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1 ■ "■ ~ " ■" ■■ 

Function 19 (xx39) 

... „ - , - ... .. . ... . .. 


■ - - ■ ■■■ ■■■■ ■ — n 

Auxiliary Output Status j 

Enter: None 

Exi t : 

~ i 

A = OFFH, NZ it Aux Output | 



Ready for output char 



A = 0, Z if Aux Out Busy 


Uses: 

AF 

i 


! 


This function return a flag indicating whether or not the Auxiliary Output 
selected by the IORYTE on Page 0 of the TPA Bank is ready to accept another 
character for output . 


Function 20 (xx3C) 


Enter: None 


Return Pointer to Device Table 


Exit: HL = Adar ot Device Table 


— a 
li 


Uses: HL 


This function roughly corresponds to an analogous CP/M Plus function a i t hough 
precise bit definitions vary somewhat . The Character 10 table consists of 
four devices: COM;, COM3 . PIO. and NT!.. Each has an input and output mash, 
data rate settings and protocol flags. Not ail del ined settings ic.g. AoK/NAE 
and XOX/XOEl handshaking, etc) may be fully implemented in each version, hv- 
are available for later expansion and use. 


Function 21 (xx3F) 


Ini ti al i ze Devi ces 


I Enter: None 


j' Exit: None. Initialization done 


Uses: All Primary Registers 


This function initializes Character 10 settings and other functions whicn may 
be varied by a Configuration Utility. It is an extended version of the corre- 
sponding CP/M Pius function. It', primary use is to restore 10 conf igurat ions, 
system parameters such as clock rate, wait states, etc. alter alteration by 
programs which directly access hardware such as many modem programs and the 
coni' i curat i on utility. BPCNFG ( see 0.2). 
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| Function 22 (xx42) Return DPH Pointer 

i . — - — = — - 

Enter: None 

Exit: HL = Address of start of 
Table of DPH Pointers 

Uses: HL 


This function returns a Pointer to a table of 16-bit pointers to Disk Parame- 
ter Headers for Drives A-P. A Null (0000H) entry means that no drive is 
defined at that logical position. 


( 

| Function 23 (xx45) 

<Reserved for Multiple 

Sector I0> ] 

r • ~ ■ — ■ 

Enter: None 

! 

j Exit: 

None . 

~ "J 

i — - . . _ — . — 

1 Uses: 

i 

No Registers 

i 

_■ _,4 


This function is Reserved in the init ial B/P Bios release and simply returns. 


Function 24 (xx43) Flush Deblocker |j 


if-— ll 


|( Enter: None 

I Exit: None. Pending Disk Writes 

ii 

Executed . 

li 

Uses: All Primary Registers 

ik=-. - . ■ ... — . — 

i - - ... - _.,J 


This function writes any pending Data to disk from deblocking buffers as men- 
tioned in Function 14 abort . This function should be called in critical areas 
where tasks are being swapped, or media is being exchanged when it is possible 
that the Operating System will not detect the change. 


f ■ — ■ 

! Function 25 (xx4B) 

i .. . 

; 

Perform Possible Inter-Bank Move j 

! 

r 

( Enter: HL = Start Source Address 

Exit: None. Data is moved 

I DE = Start Dest Address 


j BC = Number Bytes to Move 

Uses: All Primary Registers 


This function moves the specified number of bytes between specified locations. 
For banked moves, the Source and Destination banks must have been previously 
specified with an XMOVT; call (function 29). Note that the B/P implement at ion 
of this function reverses the use of the DF. and HI. register pairs 1 rom the 
CP/M 2> equivalent function. 
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Function 26 (xx4E) Get/Set Date and Time 

• — - - - 

— - 

Enter: DE = Start of 6-byte Buff 
C = 0 (to Get Date/Time) 
C = 1 (to Set Date/Time) 

- ■■ ■ ■ 

Exit: A = 1 of Successful 

A = 0 if Error or No Clock 

Uses: All Primary Registers 

... -- - - .. . - 


This function provides an interface to programs for a Real-Time Clock driver 
in the Bios. The function uses a 6-byte Date/Time string in ZSDOS format as 
opposed to Digital Research's format used in CP/M Plus for this function. 
Also, This function must conform to additional requirements of DateStamper ( tm ) 
in that on exit, register E must contain the entry contents of (DE+5) and HL 
must point to the entry (DE)+5. If the actual hardware implementing the clock 
supports 3/10 second increments, the current 1/10 second count may be returned 
in register D. 


1 “ -■ 

! Function 27 (xx51 ) 



Select Memory Bank 

t n ■ 

i Enter: A = Desired Memory Bank 

|j - - - ' 

| Exit: 

None. 

Bank is in Context 

L ..... - - ... - .... . - -J 

i 

! Uses : 

ii 

AF 

in range 0. . 7FFFH 


This function selects the Memory Bank specified in the A register and make it 
active in the address range 0-TfTli. Since character 10 may be usee when a 
bank other than the TPA (which contains the I0BVTL.1 is activated with this 
function, the B/P Bios automat ical iy obtains the I0BYTE from the TPA bank to 
insure that Character 10 occurs with the desired devices. 


r — - — • • ■ - 

1 Function 28 (xx54) 

I 

Select Memory Bank for DMA i 

! ~ ‘ ' 

Enter: A - Memory Bank for Disk 

r 

Exit: None. Bank Number saved 

DMA Transfers 

tor later Disk 10 

11 - _=_= 

Uses: No Registers 
— 


This function selects a memory Bank with which to perform Disk 10. Function 
12 (Set DMA Transfer Address) operates in conjunction with this selection for 
subsequent Disk 10. 
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j 

j Function 29 (xx57 ) 


Set Source & Dest Banks for Move j 

11 

! "" 

Enter: B = Destination 
C = Source Bank 

Bank Num 
Number 

— " - “it 

Exit: None. Bank Nums saved for 
MOVE operation 
Uses: No Registers 


This function sets the Source and Destination Bank numbers for the next Move 
(Function 25). After a Move is performed, the Source and Destination Banks 
are automatically reset to TPA Bank values. 

This marks the end of the CP/M Plus "Type” jumps and begins the unique addi- 
tions to the B/P Bios table to support Banking, Direct 10 and interfacing. 


(r ' ~ — — * 

||[ Function 30 (xx5A) Return BIOS Addresses 


L_ - - - — - ... - - . . _ 

t 1 

- - ..... - -- 1 

... ... 1 

| Enter: None 

I Exit: A = Bios Version (Hex! 

j 

i BC = Addr of Bios Base 

i 

DE = Addr of Bios Config 

f 

HL = Addr of Device Table 

j 

! Uses: All Primary Registers 
: - 


This function returns va; icus pointers ,o internal BIOS data areas and the 
Bios Version Number as indicated above . The Bios Version may be used to 
determine currency of the system software, and will be used by various support 
utilities to minimize the possibility of data corruption and/or as an indica- 
tor of supported features. 

The Base Address of the Bits Jump Table returned in register BC is often used 
to insure that the proper indexing is achieved into tne B/P data structures in 
the event that a B i os ' s;h ! 1 ' has been added such as when running NZCOM. 
While the Warm Boot jump at memory location 0000H normally points to the Bios. 
Base+3 . it is not always leliable. whereas this function will always return a 
true value with B/P Bios. 

Registers DE and HI. return pointers which are of value to programs which alter 
or configure various Bios parameters. The pointer to the configuration area 
of the Bios should be used in utilities as opposed to indexing from the start 
of the Bios Jump Table since additions to the Jump Table or insertion of other 
data will affect the Configuration Area starting address. The pointer in 111. 
is available for use in systems which may contain more than four character 10 
devices. This pointer enables exchanges of devices to place desired devices 
in the first four positions of the table making them available for selection 
via the TOBYTE. After any alterations are made to the devices, a call to the 
Device Configuration Bios Function 21 should be made to activate the features. 
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FLOPPY DISK SUBFUNCT IONS . 

Function 31 permits low-level access to Floppy and Hard Disks (via SCSI inter- 
face) by specifying a Driver Number and desired Function. While some hardware 
types do not support: all of the parameters specified, particularly for Floppy 
Drives, this architecture supports all types, although specific systems may 
ignore certain functions. In this manner, for example, a single Format pro- 
gram supports NEC765, SMC9266, WD1 770/ 1 772/179x and other controller types 
with widely differing interfaces. Floppy Disk functions are accessed by 
entering a i value into Register B (Floppy Driver Number) and the desired 
function number in Register C. then jumping to or calling BIOS Entry jump 
number 3 1 . 


i Function 31 (xx5D) 

j Floppy SubFunct ion 0 

i .. - ■ ...... - . - - ■ 

— ■■ - ■ - - — 1 1 

Set Floppy Read/Write Mode 

- . - J 

1 

i Enter: A = 0 for Double Density 

J " ' j 

j Exit: None. | 

j FF for Single Density 

i 

| B = 1 (Floppy Driver) 

| Uses : AF j 

| C = 0 (Subfunction #) 

ii= — 

i ! 

| 1 


This routine establishes the Density mode of operation of the Floppy Disk 
Controller for Read and Write accesses It assumes that SubFunct ions i ( Set 
Size and Motor) and 3 (Set Sector! have been cal lea first. 


jj Function 31 (xx5D) Set Floppy Disk & Motor Farms ij 

ji Floppy SubFunct ion 1 ji 

b - ' ~~ " ~~~ ==.==== -■ : 

i Enter: A - 0 fo r 300 rpm (normal jp Exit: None 
I FF for 360 rpm (6"/HD)ji 

ji D = FF tor Motor Control, ij Uses: AF 

ij 0 it Motor always on ij 

ji t = Disk Drive Size il 

| B = I (Floppy Driver) I 

ji C = 1 (SuPtunction it) i 


This routine establishes some of the physical parameters for a Floppy Drive. 
The normal 5.25"' and 3.5" disk drives holding 400 or 800 kb or less rotate at 
300 rpm. Many of the newer drives can increase this speed to 360 rpm which in 
the rate used on older 8" floppy drives. This is the speed used on the "High 
Density" 1.2 MB (IBM formatted) 5.25" drives. The A register is used to 
indicate the fastest speed capable on the specified drive. Register D is used 
to indicate whether the Motor is always On, or will start and stop periodical- 
ly'. This is normally used by the Bios to delay for a period before writing if 
the motor is stopped to allow the diskette to come up to speed thereby mini- 
mizing chances of data corruption. Register E is used to indicate tne phys , - 
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cal media size as: 0=IIard Disk, 001B=d" Drive. 01 OB-5.2.'' Drive, a no 
01 1B=3. 5" . Nothing is returned from this command. 

While all of these functions may not be supported on any specific compute: 
type, the interface from using programs should always pass the necessary 
parameters for compatibility. 

NOTE: This routine assumes that SubFunct ion 2 (Set Head and Drive) has been 
called first. Call this routine before calling Function 0 (Set Mode). 


r 

| Function 31 (xx5D) 

j Floppy SubFunct ion 2 

— — — n 

Set Head and Drive 

r 

i Enter: A = Drive # (Bits 0,1 ) 
j Flead # (Bit 2) 

! "1 

| Exit: None . 1 

i i 


B = 1 (Floppy Driver ) 
C - 2 (Subfunction #j 


Uses : AF 


This routine is entered with register A containing the Floppy unit number 
coded in bits o and ! (Unit 0 = 00. 1 - 01 . . 3 = 11). and t lie Head in Pi : 2 
(0 - Head 0. 1 - Head 1 ) . Nothin, i s returned t rom this function. Pali this 
Subfusc t ion before must of the others to minimize problems in Floppy accesses. 


Function 1 
Floppy Set 


lr== 




t x :• 5^ : 
met i or. 


Enter 


A = Physical Sector Number 
D = Physical Sector Size 
E. - Last Sctr # on Sice 
B = 1 (Floppy Driver; 

C = 3 (Subfunction #) 


t 


t Floppy Disk Mode 


Exit: None. 
Uses: AF 


Ji 


This routine establishes information needed to properly access a specified 
sector unambiguously with a number of different controller types. On entry. 
Register A contains the desired physical sector number desired. D contains t he 
sector size where 0 = 128 byte sectors, 1 = 256 .. 3 = 1024 byte sectors, and 
E contains the last sector number on a side. Normally register F. is unused in 
Western Digital controllers, but is needed with 765 and 9266 units. Nothing 
is returned from this subfunction. 
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1 

Function 31 (xx5D) 
Floppy SubFunction 4 

l, 

Specify Drive Times 
..... ! 

r “ ' — ■ ■ "■ ™ - 

Enter: A = Step Rate in milliSec 

I 

Exit: None. 

D = Head Unload Time in mS 


E = Head Load Time in mS 

Uses: AF 

B = 1 (Floppy Dri ver ) 


C = 4 (Subfunction #) 

= 


This subfunction set various timing values used for the physical drive select- 
ed. On entry, the A register contains the drive step rate in milliseconds. 
Within the Bios, this rate is rounded up to the nearest controller rate if the 
specified rate is not an even match. Register D should contain the desired 
Head Unload time in milliseconds, and E to the desired Head Load time in mS. 

NOTE: With Western Digital type controllers, only the Step Rate is universally 
variable. In these systems, rates signaled by the Bios settings are rounded 
up to the closest fixed step rate such as the 2. 3. 5. or 6 millisecond rate- 
in the WD] 7 ?2 or 6, 10. 20. or 30 millisecond rates used in the older VV[)r"0 
and WD1795. Nothing is returned from this function. 


Function 31 (xx5D) Home Disk Drive Heads ji 


j Floppy SubFunction 5 

t ... _ . 

r — 

| Enter: B = 1 (Floppy Driver) 

1 Exit: 

A = 0, Zerc 

Set (Z) if Ok 

i 1 

j C = 5 (Sub function tt ; 

I 

I 

A <> 0, 

NZ if Errors 

li 

ii 


i Uses: 

AF 


! 

| 

i NOTE : 

i 

Subfcns 1 , 

2, & 4 Needed 

—EL. 


This subfunction moves the head(s) on the selected drive to track 0 (home). 
Only success/failure is indicated by the value in the A register. No other 
registers may be altered by this function (especially BC). 

NOTE: This function requires that Subfunctions 1 (Set Disk and Motor Parame- 
ters). 2 (Set Head and Drive! and 4 (Specify Drive Times) be called first in 
order to establish the physical characteristics of the Drive. 
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Function 31 (xx5D) 

Floppy SubFunction 6 



Seek T rack j 

i 

I Enter: A = Desired Track Number 

Exit: A = 0, Zero Set (Z) if Ok 

D = OFFH to Verity, 

<> 0, NZ if Error 

0 for No Verification 


E = 0 for No Double-Step 

Uses: AF 

<>0 for Double-Step 


B = 1 (Floppy Driver) 

NOTE: Subfcns 2, 3, & 4 Needed 

C = 6 (Subfunction #) 

! 

— J 


This subfunction moves the headfs! for the selected drive to a specified track 
on the media. If the Double-Step flap (Register E) is set to a Non-Zero 
value, then the controller will issue two step pulses for every track incre- 
ment or decrement which is required. After the Seek, a Read ID function will 
be performed to verify that the desired track was found if the Verification 
Flag (Register 1') is set to a Non-Zero Number, preferably OFF!! . Only the AT 
registers may be altered by this function. 

NOTE: This (unction requires that Subfunctions 2 (Set Head and Drive i . 3 (but 
T loppy Disk Mode ) arid 4 ( Specify Drive Times) be called first in order to 
establish the physical characteristics of the Drive. 


i Function 31 (xx5D) 

1 Floppy SubFunction 7 

ii — 

Read Floppy Disk Sector jl 

| 

1 Enter: Hu = Dest Buffer Address jj Exit: A = 0, Zero Set (Z) if Ok j'| 

I B - 1 (Floppy Driver) 

1 <> 0, NZ if Error j| 

i C - 7 (Sub function #) 

i 1! 

j 

j Uses : AF . HL j| 

i ii 

( 

• Ii 

! NOTE: Subfcns 0,1, 2,4 & 6 Needed j| 

i: ...... ii (! 


This subfunction Reads a physical sector of data from the selected drive and 
places it in the buffer at the specified address. It is important that an 
appropriately sized buffer is provided for this task. The Value in the A 
register will indicate the success or failure of the function as indicated in 
the above chart. Only the AT and HL registers may be altered by this func- 
t i on . 

NOTE: This function requires that Subfunctions 0 (Set Read/Write Mode), i 
(Set Disk <v Motor Farms). 2 (Set Head & Drive), 4 (Specify Drive Times) and 0 
(Seek Track) be called first in order to establish the physical and logical 
characteristics of the data transfer. 
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Function 31 (xx5D) 
Floppy SubFunction 8 

1! 

Write Floppy Disk Sector j 

Enter: HL = Source Buffer Address 

jj 

Exit: A = 0, Zero Set (Z) if Ok 1 

B = 1 (Floppy Driver ) 
C = 8 (Subfunction #) 

A <> 0, NZ if Error 


Uses: AF , HL 


NOTE: Subfcns 0,1, 2, 4 & 6 Needed j 
L ! 


This subfunction writes data from the buffer beginning at the specified ad- 
dress to the track, sector and head selected by other subfunctions. The value 
in the A register along with the setting of the Zero Flag will indicate wheth- 
er the operation succeeded or not. Only the AT and HL registers may be al- 
tered by this function. 

NOTE: This function requires that Subfunctions 0 (Set Read/Write Mode), 1 

(Set Disk k Motor Farms). 2 (Set Head & Drive). 4 (Specify Drive Times) and 
(Seek Track) be called first in order to establish the physical and logical 
characteristics of the data transfer. 


Ir= — ' = ~ ~ 5 1 

(I Function 31 (xx5D) Read Disk Sector ID 1 

| Floppy SubFunctior. 3 i! 


j Enter: 

B = 1 (Floppy Driver! 

i Exit: 

A = 0, Zero Set (Z) it 01 

i 

C = 9 (Subfunction #) 

j 

i 

A <> 0, NZ it Error 

! 

1 


i 

j Uses: 

AF 

i 


i NOTE: 

Subfcns 0 & 2 Needed 




This Subfunction reads the first correct ID information encountered on a 
track. There are no entry parameters for this function other than the Driver 
and Subfunction number. A flag is returned indicating whether or not errors 
occurred. An error indicates that no recognizable Sector ID could be read on 
the disk. In most cases, this is due to an incorrect Density setting in the 
Rios . 

NOTE: This function requires that Subfunctions 2 (Set Head k Drive! and 3 
(Set Floppy Disk Mode! are called first in order to establish the physical 
characteristics of the disk. 
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i Function 31 (xx5D) 

Return Floppy Drive Status 

| Floppy SubFunction 10 

t ... _ .... . ..... . 


Enter: B = 1 (Floppy Driver) 

Exit: A = Status Byte of last Opn 

C = 10 (Subfunction #) 

BC = FDC Controller Type 
HL = Address of Status Byte 


Uses: AF, BC, HL 
NOTE: Subfcn 2 Needed 


This function returns the status of the currently-selected drive. There arc 
no entry parameters for this function other than the Floppy Driver and Func- 
tion number. On exit, the raw unmasked status byte of the drive, or the last 
operation depending on the controller type, is returned along with a binary 
number representing the FIX' controller type (e.g. 765. 9266. 17“2. etc;. 

NOTE: This routine assumes that Subfunction 2 (Set Head & Drive) has been 
called before this routine to select the Physical Parameters. 


I Function 31 (x>5D) Format Floppy Disk Track [ 

i Floppy SubFunction 11 jj 


ii Enter: HL - Pointer to Data Block! 
j D = # of Sectors/Track | 
j E = # of Bytes in Gap 3 j 
j B = 1 (Floppy Driver) ! 
! C =•■ 11 (Subfunction #) | 


Exit: A = 0, Zero Set (Z) it Ok |j 
A <> 0, NZ if Error ii 

ii 

Uses: AF,BC,DE,HL jj 

NOTE: Use Subfcn 10 tor Cont Type'll 


J L 


This Sub function formats a complete track on one side of a Floppy Disk. It 
assumes that the Mode. Head/I; r i vc- . Track, and Sector have already been set. 
On entry. HI. points to data required by the controller to format a track. 
This varies between controllers, so RETDST should be called to determine 
controller type before setting up data structures. On entry, D must also 
contain the number of Sectors per Track, and E must contain the number of 
bytes to use for Gap 3 in the floppy format. On exit. A=0 and the Zero flag 
is Set (Z) if the operation was sat isfactori ly completed. A <> 0 and the Zero 
flag cleared (NZ) if errors occurred. This routine may alter all primary 
registers ( AF,BC,DE,HL ) . 

NOTE: This routine assumes that Subfunction 10 (Return Floppy Drive Status) 
has been called first to determine the Controller type and insert the correct 
information in the Format Data Block. 
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HARD DISK SUBFUNCTIONS. 

These functions are available to directly access Hard Drives connected by a 
SCSI type interface. They are accessed by loading the desired function number 
in the C register, loading a 2 (SCSI driver) into the B register and calling 
or jumping to Jump number 31 in the Bios entry jump table. Since this inter- 
face is not as standardized as Floppy functions in order to handle SASI as 
well as SCSI devices, the interface has only basic functions with the precise 
operations specified by the User in the Command Descriptor Block passed with 
Function 2. While this places a greater burden on User programs, it allows 
more flexibility to take advantage of changing features in the newer SCSI 
drives. 


= -- - --- - - ■ ■ - ■ ' ~ =-■ ^^=jj 

Function 31 (xx5D) Set Hard Disk Addresses j 

Hard Disk SubFunction 0 j 


jj Enter: DE = Address of Data Area |i Exit: A = # Bytes in Comnd Block jj 


li 

B = 2 

(Hard Disk Driver) 


li 

II 

Ik-— _ 

C = 0 

{Subfunction #) 

i Uses: AF 

|i 


This Subfunction sets the User Data Area Address for Direct SCSI I 0 . and 
returns the number of bytes aval table in the SCSI Command Descriptor Block . 
The Data Area must be AT I.EAST 512 bytes long and is used to store data to be 
written, and to receive data read from the selected drive. This Data Area 
size is mandatory since 512 bytes are always returned from a direct access in 
order to handle the wide variety of controller types recognized in the B/P 
Bios drivers. The numbei of bytes available in the Command Descriptor Block 
within the physical driver is usually 10 in order to handle the extended SCSI 
commands, but may K scaled back to b in limited applications. 


r~ 

j Function 21 ( xx5D ) 

Set Physical & Logical Drive j 

| Hard Disk SubFunction 1 

1 

I 

j Enter: A = Device Byte (5.2.1) 

Exit: A = Physical Device Bit 

j B = 2 (Hard Disk Driver) 


j C = 1 (Subfunction ft) 

i — — — 

Uses : AF 


This Subfunction sets the Physical Device bit in the Bios for SCSI accesses 
and the Logical Unit Number in the SCSI Command Block (Byte 1, bits 7-5). The 
format of the Device Byte provided to this routine is defined in the Configu- 
ration Data. Section 5.2.1. CONFIG+61. and is available from the Extended Disk 
Parameter Header at DPI I- 1 . On exiting this routine, a byte is returned with a 
"One" bit in the proper position (Bit 7 = Device ...Bit 0 = Device 0 > to 
select the desired unit via a SCSI command. 
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Function 31 (xx5D) 

Hard Disk SubFunction 2 

! 

- It 

Direct SCSI Driver \ 

! 

Enter: DE = Ptr to Comnd Desc Blk 

Exit: A = Bitl Status, Flags Set 

A = 0 if No Write Data 

H = Message Byte Value 

A = FF if Data to Write 

L = Status Byte Value 

B = 2 (Hard Disk Driver) 
j C = 2 (Subfunction #) 

Uses: AF,BC,DE,HL 

I 

NOTE: Subfcns 0 & 1 Needed j 

i 


This Subfunction performs the actions required by the command in the specif icd 
Command Descriptor Block. The flag provided in Register A signifies whether 
or not user data is to be written by this command. If set to a Non-Zero 
value. Data from the area specified with Function 0 will be positioned for 
SCSI write operations. At the end of the routine. 512 bytes are always trans- 
ferred from the bios 10 buffer to the Users Space set by Subfunction 0. This 
may be inefficient, bin was the only way we could accommodate the wide variety 
of different SAS] /SCSI controllers within reasonable code constraints . The 
status returned at comp lei ion of this function is the Status byte masked with 
the Check bit . bit i. The full Status B> te and Message Byte from SCSI opera- 
tions are also provided for more definition of any errors. 

NOTE: This routine assumes that the Command Descriptor Block has been properly 
configured lor tile type of Hard Disk Controller set in B/P Bios, and that the 
selected disk is properly described t if necessary ; in the bios Unit clef. lo- 
tions. Errors in phasing resuit in program exit and Warm Boot. It assumes 
the user has called Functions 0 ( Set Hard Disk Addresses) and 1 i>.et Phvsica ! 


Log j ca 1 Dr i ves } be 1 o re u •> i ng t h i s 

Subi unct 

ion. 


i - ■ — ■ — 

; Function 32 (xxoO) 

Se 

t Ban!-, for Far Jump/Cal! 

1 

j 

1 Enter: A - Desired Bank Number 

r 

| Exit: 

None. 



j Uses: 

No Registers 



This Function sets the bank number for a later Function 33 Jump to a routine 
in an alternate Memory Bank. 
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i Function 33 (xx63) Jump to (HL) in Alternate Bank i 

i j 

1 

Enter: HL = Address to execute 

in Bank set w/Fn 32 

i 

Exit: <Unknown> Called routine 
sets return status 
Uses: All Primary Regs (assumed) 

j- 


This Function switches to the bank number previously specified with Function 
32, then calls the routine addressed by HL. Upon completion, operation re- 
turns to the bank from which called, and the address on the top of the stack. 


Function 34 (xx66) 


Clear Stack Switcher 


Enter: HL = Addr to resume exec 
in entry bank 


Exit: None. Execution resumes 
at addr in HL in entry bank 
Uses: No Registers 


This Function is used for error exits from banked routines to return to the 
entry bank. 



IS 


Vi 


Function 35 (xx69) 


Enter: HL = Addr of desired by 
C = Desired Ban! Numbe 


toad A , ( HL ) trom Alternate Bank 

V — 

te lj Exit: A - Byte fror C:HL 
r ii 

I! Uses: AF 



This Function .sets a byte (k-bits) from the specified Bank and Address . The 
hank is temporarily switched in context for the. access (if required? . then 
restored to entry conditions. Interrupts are temporarily disabled during the 
brief access time. 


Function 36 (xx6C) 


Load DE,(HL) from Alternate Bank 


Enter: HL = Addr of desired word 
C' = Desired Bank Number 


Exit: DE = Word from C:HL 
Uses: AF,DE 


This Function gets a Word (lo-bits) from the specified Bank and Address. The 
bank is temporarily switched in context for the access (if required), then 
restored to entry conditions. Interrupts are temporarily disabled durine the 
brief access time. 
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Function 37 (xx6F) 

= 

Load (HL),A to Alternate Bank j 

i 

Enter: HL = Addr of Dest Byte 

Exit: None. Byte stored at C:HL 

C = Desired Bank Number 


A = Byte to save at C:HL 

Uses: AF 


This Function saves a Byte (8-bits) to the specified Address and Bank. The 
bank is temporarily switched in context for the access (if required), then 
restored to entry conditions. Interrupts are temporarily disabled during the 
brief access time. 


r~ 

| 

Function 

38 (xx72) 


Load 

( HL ) , DE 

to Alternate Bank ji 

f— 

i 

Enter: DE 

= Word to 

store at C:Hl 

! " 

Exi t 

None . 

" '■ - ■' ““ 11 

Word stored at C:HL ji 

1 

HL 

= Addr of 

Dest Word 



1- 

f 

ii 

c 

= Desired 

Bani\ Number 

Uses 

AF 

i! 




This Function saves a Word lo-bits! to the specified Address and Ban!:. The 
bank is temporarily switched jn context lor the access (if required) . then 
restored to entry condition . line: runts are temporarily disabled during the 
brief ac. t ime. 


Return Current Bank in Context ji 

jj Exit: A = Bank currently active ii 
|j in Addr 0. . 7FFFH | 

ji Uses: AF ii 

Ji - ij 

This Function returns the Memory Bank currently in Context in the address 
range of 0. . “FFf H. It may be used in the 'where am I’’ role in application 
programs to track memory accesses. 



ji Enter: Noise 

ii 


ii 

ii 
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5.2 Bios Data Structures. 

5.2.1 Corvrigu ration Area. 

Much of the ability to tailor B/P Bioses to your specific operating needs is 
due to the standardized location of many discrete elements of data, and a 
facility to easily locate and change them, regardless of the particular hard- 
ware platform in operation. Bios Function 30, Return Bios Addresses, reports 
the base address of the Configuration Area in the DF. register pair. in this 
section, we will review each of the specified elements, their functions, and 
which parts of the data must be rigidly controlled to insure that the supplied 
utilities continue to function, as well as guarantee the portability of other 
programs . 

CONFIG-6 - Bios ID. Character String, 6 bytes. 

This character string MUST begin with the three characters "B/P in Uppercase 
Ascii, followed by three Version-specific identifying characters. As of March 
1993, the following identifiers have been assignee: to systems: 


"B/P-YS" 

“B/P-AM" 

"B/P-18" 

"B/P-CT" 

"B/P-TT" 

"B/P-XL" 


YASB'f.C 

Ampro little Board 100 
Micro.Mint SB-.I80 
Compu/lime SI 00 Board Set 
1 e letek 

intei J i gen t ( ompu ter Des i gns XI -M 1 su 


CONF1G+0 - IOBYTE. Byte. 

This byte contains the initial definition of the byte placed at ofi set 3 on 
the Base Page ( 0003H 1 during a cold Boot and determines which ol the iou; 
defined character 10 devices wili oe used as the Console. Auxiliary am Print- 
er devices. The default setting may he altered by Bl'CNFG to reflect changed 
device configuration--, or by reassembly of the Bio-.. 

T i i e bit definitions in tins b\ t e art : 


Bit 7 6 5 -1 3 2 1 0 



Console Device 
Auxiliary Input Device 
Auxiliary Output Device 
Printer Device 


CONFIG+1 - System Drive. Byte. 

This byte contains the drive which will be accessed alter a Cold Boot and is 
assumed to contain the Operating System files. It is a binary value where A - 
0 . B = 1 . . . P = 15. 
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CONFIG+2 - Bios Option Flags. Byte. 

This hvte consists of individual )y mapped bits which display which options are 
active in the assembled Bios. The bits listed as <reserved> should not be 
defined without prior coordination with the system developers to preclude 
conflicts with planned enhancements. The byte is currently defined as: 


Bit 7 6 5 4 3 2 1 0 



0 = Unbanked Bios 
0 = Bank in RAM 
0 = DPBs Fixed 
0 = ALV/CSV in TPA 
< reserved > 


1 = Banked Bios 
1 - Bank in ROM 
1 = DPBs Assignable 
1 = ALV/CSV in Bank ( ZSD0S2 ) 


The next five bytes define the memory map of a banked system in 32k slices. 
For a complete description of Bank allocations, piease refer to Section 4. In 
non-banked systems, all except the FLAM Drive Bank should all be set to 0. If 
no memory is available for re-assignment as a RAM drive, this byte as well 
should be set to 0. 


CONFIG+3 - User Bank. Byte. 

This Byte reflects the Bank number reserved for User Applications. 

CONFIG+4 - TPA Bank. Byte. 

This Byte reflects t he Bank number reserved for the Transient Program Area in 
the address range o! u.AFFftl. The next sequential bank number is normally 
the Common Bank which always remain in Context in the addressing ranee of 
•8U00 . . FFFFT1 and contain-' if:, 'xtatine System. Bios and /.-System tables. 

CONFiG+5 - SYStem Bank. Byte. 

This byte reflects the Ban-, number containing any executable- code and data 
specified, for the System Bank. 

CONFIG+6 - RAM Drive Bank. Byte. 

This byte reflects the starting Bank number available for use as a RAM Drive. 
It is assumed that all RAM from this Bank through trie Maximum hank Number i: 
contiguous and available as a RAM Drive. 

CONFIG+7 - Maximum Bank Number. Byte. 

This byte ret iects the number ol the last available bank of RAM in the system. 
In many systems, it may be set to different numbers depending on the number of 
RAM chips installed in the system. 

CONFIG+S - Common Page Base. Byte. 

This byte reflects the Base Page of the Common area in systems which do not 
fully comply with the 32k Memory Banking architecture of B/P Bios, but can be 
made somewhat compliant. This Byte must be AT LEAST 80H. but may be higher if 
needed. 

CONFIG+S - DPB Size. Byte. 

This by i e con rains the 1 eng t h of Di s k Paramo ter Block all oca t i o ns within t he 
Bios. Since more information Is needed than the 13 bytes, defined by Digital 
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Research in C'P/M 2.2, an extended format is used. All re-ass ignmentS of Disk. 
Parameter data should use this byte to determine the size of records. 

CONFIG+IO - Number of DPBs in Common RAM. Byte. 

CONFIG+11 - Number of DPBs in System Bank.. Byte. 

These two bytes indicate the complete complement of Floppy Disk formats avail- 
able within the Bios. In most cases, one of these two bytes will reflect a 
zero value with all Disk Parameter Blocks resident either in the Common area 
or in the System Bank. The provisions are available, however with these two 
bytes to split the definitions for custom versions without voiding the support 
tools provided. 

CONFIG+12 - Pointer to first Common DPB. Word. 

CONF1G+14 - Pointer to first Banked DPB. Word. 

These two words point to the first DPB in a sequential list within the respec- 
tive memory banks for Disk Parameter Blocks defined in the preceding bytes. 
In most cases one of these two words wi 1 1 be a Null pointer (OOOOH) corre- 
sponding to no data as described in the count bytes above. 


CONFIG+16 - Initial Startup Command. String. 

This string contains the first command which will be initiated on a Cold Boot. 
It is loaded into the Multiple Command Buffer defined in the Environment 
Descriptor (See 5.2.4) and calls a file of the specified name with a type of 
'COM". The string may have up to eight characters and must be Nul 1 -terminated 
(end with a Binary 0). The string is defined as: 

Byte ~ Number of Characters (0..8) 

String - 8 bytes tor Ascii characters {usually Uppercase) 

Byte - Terminating Null (binary 0) 

CONFIG-f 2 d - Pointer to Environment Descriptor. Word. 

This Word points to the first byte of an extended Z34 Environment which MUST 
begin on a Page boundary (xxOOID. See Section 5.8.1 for a complete descrip- 
tion of the Environment Descriptor and B/P Bios unique features. 

CONFIG+28 - Banked User Flag/Bank Number. Byte. 

This Byte may be used as a flag to indicate whether or not a User Bank is 
defined. Bank 0 cannot be used as a User bank by decree of the system au- 
thors. Therefore, if this byte contains a binary 0, no User Bank is avail- 
able. 

CONF1G+29 - Pointer to Start of Banked User Area. Word. 

This word contains the address, of the first available byte in the Banked User 
Area, if one exists. Routines loaded into the User Bank should contain a 
standard RSX header structure to link sequential programs and provide a primi- 
tive memory management function. 

CONFIG+31 - CPU Clock Rate in Megahertz. Byte. 

This byte must contain the processor speed rounded to the nearest Megahertz. 
It may be used by software timing loops in application and utility programs to 
adapt to the clock speed of the host computer and provide an approximate time. 
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This byte is reflected in the Environment Descriptor (see 5.2.4) ns well for 
programs which are Z-System "aware . 

CONFIG+32 - Additional Wait State Requirements. Byte. 

This byte is "nibble-mapped" to reflect the number of wait states needed lor 
memory and 10 accesses when these functions can be set via software. In the 
Z80/Z180, JO port accesses have one wait state inserted within the processor. 
This byte does not account for this fact, and reflects wait states IN ADDITION 
TO any which are built into the hardware. For older processors such as the 
Z80, these bytes normally have no el feet since additional wait states must be 
added with hardware. 

CONFIG+33 - Timer Reload Value. Word. 

In many systems. Interrupts or Timer values are set by software-configurable 
countdown timers. the 16-bit value at this location is reserved for sett im; 
the timer value and may be "fine tuned' to allow the system to maintain cor- 
rect time in the presence oi clock frequencies which may deviate from precise 
f requenc i es needed 1 o r accui ate c 1 ocks . 

CONFIG+35 - Floppy Disk Physical Parameters. Table. 

This table consists of lour 5-byte entries which contain information on up to 
four physical drives. Each entry is defined as: 

Byte 0 - Provides base for XDP11 byte. Bit mapped as: 


Disk Size 000=Fixed Disk, 001=8”, 010=5.25”, 011=3.5” 

0 = Single-Sided, i = Double-Sided 

<reserved> 

0 = Motor Always On 1 = Motor Control Needed 

0 = 300 RPM Max Speed 1 = 360 RPM (8" & HD) 

< reserved > 

Byte 1 - Step Rat. in mi 1 1 i seconds . 

Byte 2 - Head Load Time in milliseconds. 

Byte 3 - Head Unload Time in milliseconds. 

Byte 4 - Number oi tracks (Cylinders) on drive. 

Those bits in Byte 0 which are listed as unused must be set to 0 since this 
byte provides the initial value stored in the XDPH when assignable drives are 
used. for controllers which do not need the available information (e.g. 
Western Digital controllers do not need Byte 3), these values may be set to 
any arbitrary value, but MUST remain present in the structure to prevent 
changing subsequent addresses. 

CONFIG+55 - Motor On Time in 1/1 0th Seconds. Byte. 

This time may be used in some types of Floppy Disk controllers to keep the 
drive motors spinning for a specified time after the last access to avoid 
delays m bringing the spindle up to speed. Some controllers, notably the 
Western Digital 1 7 xx and lbxx series to not support this feature. In this 
case, the byte may be set to any arbitrary value, but MUST remain present. 
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CONFiG+56 - Motor Spinup Time in 1/10th Seconds. Byte. 

Inis time is the delay which will be imposed by the Bios before attempting to 
access a Floppy Disk drive when it senses that the motor is in a stopped 
condition. Providing such a delay will minimize the probability of data 
corruption by writing to disk which is rotating at the incorrect speed. 

CONFIG+57 - Maximum Number of Retries. Byte. 

This byte specifies the number of attempts w'hich will be made on a Floppy Disk 
access before returning an error code. In some cases, such as diagnostic 
programs, it may be desirable to set this value to 1 to identify soft errors, 
or ones which fail on the first attempt, but succeed on a subsequent try. Vie 
recommend a value of 3 or 4 based on our experience. Larger values may result 
in inordinately long delays when errors are detected. 

CONFIG+58 - Pointer to Interrupt Vector Table. Word. 

This Word contains the address of the base of an Interrupt Vector Table which, 
when used, contains pointers to service routines. The precise definition of 
the table is not standardized and may vary considerably between systems. This 
pointer serves only to provide an easy and standardized method of locating the 
table for re-definition of services or system features. 

CONFIG+60 - SCSI Controller Type. Byte. 

To accommodate the widest variety of different controllers including the older 
SASI models, this byte is defined as containing a byte code to the specific 
model being used. In most cases . this byte has little j 1 any effect within 
the Bios, but may have significant effects on Hard bisk Diagnostic programs . 
or User-developed utilities. Any additions to this table should be coorui bat- 
ed with the authors to insure that the standard support utilities continue to 
function. Current definitions are: 

Ow i 

Adaptec ACB-40DDS 
Xebec i 410A/ Shura rt 1 (> 1 0-3 t SASI I 
Seagate SC’S I 

Shugart 1 ol 0-4 (Minimal SCSI subset! 

SCSI-2 (Newer Conn-.-! . quantum ana Maxtor drives i 
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CONFIG+61 - Hard Drive Physical Parameters. Table. 

This tabie consists of three 4-byte entries defining up to three physical Hard 
Drives. While the SCSI definition allows for more units, three was considered 
adequate for most systems. If additional drives are needed, please contact 
the authors for methods of including them without invalidating any of the 
standard utilities or interfaces. Each of the three entries is defined as: 

Byte - Physical and Logical Address as: 

Bit 7 6 5 4 3 2 1 0 

Physical Device (000-1 10B, 11 IB reserved for Host) 
<reserved> 

0 = Drive NOT Present, 1 = Drive Present 
Logical Unit Number (000-111B) for controllers 
capable of handling multiple drives 

Word - Number of Physical Cylinders on Drive 
Byte - Number of Usable Physical Heads on Drive 
Word - Cylinder Number to begin Reduced Write Current 
Word - Cylinder Number to begin Write Precompensation 
Byte - Step Rate. This byte may either be an absolute rate in mS or a 
code based on controller-specific definitions 

For many of the newer controllers, the last three items may not have any 
meaning in which case they can he set to any arbitrary value. Also in newer 
drives, the physical characteristics such as the number of cylinder.- and heads 
may be hidden wi thin the drive electronics with re-mapped values provided to 
the controller via various J-.CSI commands. As with the last three entries, in 
this case, they rm \ be set to any arbitrary value. 

CONFiG+88 (Reserved Bytes), live bytes are reserved for future expansion. 

CONFlG+93 - Character Device Definitions. Table. 

This table consists oi lour or more- 16-byte (8-bvte in B/P version-, prior to 
1.1} entries and must be terminated by a Null (binary Zero) byte. Each entrv 
defines the name and characteristics of a character device in the system. The 
first Jour of these are directly available for selection by the IOBY'Tt as the 
Console. Auxiliary 10 and Printer. Other entries may be defined and exchanged 
with the first lour to make them accessible to the system. The entries are 
defined as: 

String - Four Ascii character Name as: COM1 , PI01, NULL, etc. 

Byte - fiat a Rate capabilities as: 

Bit 7 6 5 4 3 2 1 0 

Current Data Rate Setting 

Maximum Rate Available (Bits-per-Second) as: 


0000 

= None 

0001 

= 134.5 

0010 = 50 

0011 

= 75 

0100 

= 150 

0101 

= 300 

0110 = 600 

0111 

= 1200 

1000 

= 2400 

1001 

= 4800 

1010 = 9600 

1011 

= 19200 

1100 

= 38400 

1101 

= 76800 

1110 = 115200 

1111 

= F i xed 
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Byte 


- Configuration Byte 

Bit 76543210 


0 

0 

0 

0 

0 

0 

0 


defined as: 


= 2 Stop Bits, 1 
= No Parity, 1 
= Odd Parity, 1 
= 8-bit Data, 1 
= No XON/XOFF , 1 
= No CTS/RTS , 1 


= Device NOT Input, 1 
= Device NOT Output, 1 


1 Stop Bit 
Parity Enabled 
Even Parity 
7-bit Data 

XON/XOFF Control Enabled 
CTS/RTS Control Enabled 
Device can be read 
Can Write Device 


Byte - Input Data Mask. Bit-mapped byte used to logically AND with 
bytes read from Device Input. 


Byte - Output Data Mask. Bit-mapped byte used to logically AND with 
bytes before being output to device. 

Word - Pointer to Character Output routine. 

Word - Pointer to Output Status routine. 

Word - Pointer to Character Input routine. 

Word - Pointer to Input Status routine. 


NOTE: The last four pointers are not at these locations in B/P Bios versions 
prior to 1 . J . but were accessed by a pointer returned by Bios Function 3u. 


5.2.2 Disk Parameter Header. 

The Disk parameter Header (DPI!) is a logical data structure required for each 
disk drive in a CP/M compatible Disk Operating System. It consists of a 
series of eight pointers which contain addresses ol other items needed by the 
DOS as well as some scratchpad space. The Address of the DPI! associated with 
a given drive is returned by the Bios alter a successlul selection with Bios 
Function 9. If Errors occur during selection, or the drive does not exist, a 
Null Pointer (000011) is returned. 

For B/P Bios, it was necessary to add an additional four bytes to each DPI: 
which contain additional information on physical and logical parameters as 
well as flag information. These additional bytes are referred to as the 
Extended DPI i . or XDPll. While similar in concept to the extension added to 
CP/M 3. the implementation is different. The XDPH prepends the DPH and may be 
accessed by decrementing the returned address. As a convention. DPlls in B/P 
Bios source code have reserved certain label sequences for specific types of 
units with DPH00-PPH49 used for Floppy Drives, DPH50-DPH89 for Hard Drive 
Partitions and DPH90-DPH99 for RAM Drives. 

An entire DPH/XDPil block is required for each logical drive in a B/P Bios 
system. While some pointers, such as the pointer to the Directory Buffer, may 
be common across a number of drives, for most systems, the other items will 
point to unique areas. 

The DPH /XDPH elements as indexed from the DPH addresses accessible to appiica- 
t ion prog r am s a re: 
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DPH-4 - Format Lock Flag. Byte. 

A Zero value indicates that the format of the disk is not fixed, but may be 
changed. If the Bios was assembled with the Auto-select option, the Bios will 
scan a number of different formats in order to identify the disk. If a OFFH 
value is placed in this byte, it indicates that the format is fixed and cannot 
be changed. This is normally the case for RAM and Hard disk drives, as well 
as for alien floppy formats which have been selected in the emulation mode. 
If the Auto-select option was not chosen during assembly of the Bios, all 
Floppy Disk drives will also have a OFFH byte in this position showing that 
the formats cannot be changed. 

DPFI-3 - Disk Drive Type. Byte. 

This byte is bit mapped and contains flags indicating many parameters of the 
drive. For Floppy Drives, this byte contains a copy of the first byte in the 
Physical Drive Table (See 5.2.1, CONT 10+35 ) with the two reserved bytes set 
during the drive select ion process. The byte is then defined as: 


Drive Type Byte 


Bit 7 6 5 4 3 2 1 0 



Disk Size 000=Fixed Disk, 001 
0 = Single Sided 
0 = Single Step Drive 
0 = Motor Always On 
0 = Max Speed 5.25" (300 rpm) 

0 = Double Density 


=8", 010=5.25", 011=3.5" 

1 = Double Sided 
1 = Double Step Drive 
1 = Drive Motor Control Needed 
1 = 8" & HD Max Speed (360 rpm) 
1 = Single Density 


For Hard Disk Partitions and the Ram Drive, this byte is not used and is set 
to all Zeros indicating a fixed Drive type. 

DPH-2 - Driver ID Number. Byte. 

Three Driver Types arc used in the basic B/P Bios configuration. A Zero value 
indicates a Non-existent driver, with other values used to direct disk access- 
es to the respective code appropriate to the device. Basic del med driver 
types exist lor 1 ioppy Disk { 1 ) , Hard Disk via the SCSI interface (2). and RAM 
Disk (3). I i you wish to extend this table to include tailored drivers, 
please consult with the authors to preclude possible conflicts with planned 
ex tens i ons . 

DPFi-1 - Physical Drive/Unit Number. Byte. 

This byte contains the Physical Drive or Unit Number hosting the logical 
drive. For Floppy Drives, this will usually be in the range of 0 to 3 for 
lour drives. Hard drives may have several DPHs sharing the same physical 
drive number, while this field is ignored in the single RAM drive supported in 
the distribution B/P bios version. 

NOTE: The Physical Drive Number byte tor Hard Drives is comprised of two 
fields to ease handling of SCSI devices. Up to seven devices (device 1 1 IB is 
reserved lor the Hos t Computer? each having up to H Logical Units max be 
defined. The Byte is cont igured as: 
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Ph ysica l Drive Number 


Bit 7 8 5 4 3 2 1 
I I L_L 


Physical Device (000-1 10B, 11 IB reserved for Host) 
<reserved> 

0 = Unit Not Available, 1 = Unit Active 
Logical Unit Number (000-111B) 


DPH+O/1 - Skew Table Pointer. Word. 

This word contains a pointer to the Skew table indicator. It rarely is used 
for Hard and RAM drives, but is required in Floppy Disk drives. If the Bios 
was assembled using the Calculated Skew option, the address is of a Byte whose 
absolute value indicates the numerical value of skew (normally in the range of 
1 to 6) used for disk accesses. This term is often replaced with Interleave, 
and is synonymous for this purpose. If the value of the byte is negative, it 
means that the sectors are recorded in a skewed form on the disk and that 
Reads and V. rites should be sequential. If the value is positive, then an 
algorithm is called to compute a physical sector number based on the desired 
logical sector and the skew factor. For systems assembled without Calculated 
skew, this word points to a table of up to 26 bytes which must be indexed with 
the desired Physical Sector number (0.. Maxi mum Sector Number) to obtain the 
Corresponding Disk Sector number. 

DPH+2 - Dos Scratch Words. 3 Words. 

These three words are available lor the Dos to use as it requires . No 1 1 xeci 
values are assigned, nor are meanings tor the data stored there of any value. 

DPH+S/9 - Directory Butter Pointer. Word. 

This word points, to a 128-byte Data area that is used for Directory searches. 
It is usually a common area tc ai 1 DPH's in a system and is frequently updated 
by the Dos in normal use. 

DPH+10/1 f - DPB Pointer. Word. 

This word points to another data structure which details many of the logical 
parameters of trie selected drive or partition. Its structure is detailed in 
Section 5.2.3 below. Drives of the same type and logical confiaurat ion mar 
share DPB definitions, so it is not uncommon to find the DPB pointers in 
different DPH structures pointing to the same area. 

DPH+12/13 - Disk Checksum Buffer. Word. 

This word points to a scratch RAM buffer area for removable-media drives used 
to detect disk changes. Normally this feature is used only for Floppy Disk 
Drives, and is disabled bv containing a Zero word (000011) for Hard and RAM 
drives. For Floppy Drives, a RAM area with one byte for every four directory 
entries (128-byte sector) is needed (See 5.2.3, DPH+11/12). This scratch area 
cannot be shared among drives. 

It should be noted that in a fully Banked B/P Bios system with ZSD0S2 , the 
Checksum buffer is placed in the System Bank and not directly accessible by 
appl icat ions programs . 
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DPH+14/15 - Allocation Vector (ALV) Buffer. Word. 

This word points to a hit-mapped butler containing one bit for each allocation 
block on the subject drive (See 5.2.3. DPB+5/B). A "1' bit in this butter 
means that the corresponding block of data on the device is already allocated 
to a fiie. while a "0‘" means that the block is free. This buffer is unique to 
each logical drive and cannot be shared among drives. 

It should be noted that in a fully Banked B/P Bios system with ZSD0S2 . the Add 
Buffer is placed in the System Bank and not directly accessible by applica- 
tions programs. Since access to the ALV buffer is frequently needed to comp- 
ute free space on drives. ZSD0S2 contains an added function to return disk 
free space. Using this cail allows applications access to the information 
without directly accessing the data structure. 


5.2.3 Disk Parameter Block. 


The Disk Parameter Block ( DPB ) is a data structure defined by Digital Research 
for CP/M which defines the iogicaj configuration of storage on mass storage. 
It has been expanded in B/P Bios to include additional information to provide 
enhanced flexibility and capability. The expansion is referred to as the 
Extended DPB or XDpb, and prepends the actual DPB structure. The address of 
the DPB may he obtained Iron: the DPH pointer returned by the Bios or Dos after 
a disk selection (See 5.2.2 above). All DPBs reside in the Common Memory area 
and arc available to applications programs whether in a Banked or Unbanked 
system, for the sake of a convention, the DPBs are labeled in the same mannci 
as DPils with DPBOO-DPBTb used tor I loppy Drives. DPB50-DPB8P for Haro Drive 
Partitions, and DPBPO-Pw tor RAM Drives. 


The layout oi the Disk Parameter Block as indexed from the available DPr 
point o r is: 


DPB-16 - Ascii ID String. 10 Bytes. 

'Ibis string serves as an identification which may be printed by applications 
programs such as our BPFORMAi . This string may be a mixed alphanumeric Ascii 
set oi up to ten characters, but the last valid character must have the Most 
Significant Bit (Bit " ) Set to a T. 


DPB-6 - Format Type Byte 0. Byte. 

This byte contains some of the information about the format ol the drive, and 
the logical sequencing ol information on the physical medium. The bits in the 
byte have the following significance: 


Bit 


7 6 5 4 3 2 1 0 



Disk Size: 000 = Fixed Disk, 001 = 8", 010 = 5.25", 011 

Track Type 

000 = Single Side 001 = Reserved 

010 = Sel by Sec, Cont 011 = Sel by Sec, Sec # Same 

100 = SO All , SI All 101 = SO All, SI All Reverse 

110 = Sel by Trk LSB 111 = Reserved 

0 = Track 0 Side 0 is Double Density, 1 = Single Density 
0 r Data Tracks are Double Density, 1 = Single Density 
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For Hard Drives and RAM Drives, this byte contains all Zero bits to signify 
Fixed Media and format. 

DPB-5 - Format Type Byte 1. Byte. 

This byte contains additional information about the format of information. 
The bits have the following meanings: 


Sector Size: 000 = 128, 001 = 256, 010 = 512, 011 = 1024 

Allocation Size: 000=1K, 001=2K, 010=4K, 011=8K, 100=16K 

(NOTE: This should match the definition in DPH ) 

<Reserved> 

0 = Normal Speed (300 rpm) 

1 = 8" & HD Floppy (360 rpm) or Hard Drive 

For Hard Drives. The distribution version of B/P Bios and the support 
utilities assume that the Sector size is always 512 bytes. The remaining bits 
should be set as indicated. 

DPB-4 - Skew Factor. Byte. 

This byte is a signed binary value indicating the skew factor to be used 
during Format. Read and Write , it is normally used only with floppy Drives 
and usually set to -1 (Oil'll) for Hard ami RAM drives to indicate that Reacts 

and Writes should be done with No skew. If the option to calculate skew is in 

effect during Bios assembly, the Skew pointer in the DPH ( BPli-eO/ 1 ) points to 
this byte. If a skew table is used, this byte has no effect and snouJci be set 
to 8 OH. 

DPB-3 - Starting Sector Number. Byte. 

This byte contains the number o: the first Physical Sector on each track . 

Since most Disk operating Systems use a Zero-based sequential scheme to refer- 
ence sectors . this value provide s tne initial offsev to correct logical to 

phy s i ca 1 sect or numbe r s . 

DP6-2 - Physical Sectors per Track. Byte. 

This byte contains the numbe r of Physical (as opposed to logical) Sectors on 
each track. For example, CP/M computes sectors based on 1 28-b.vte al locat ions 
wnich are used on single-density 8 Floppy Disks. One of the popular rive- 
inch formats uses five lk physical sectors which equates to 40 logical CP/M 
sectors. This byte contains 5 in this instance for the number of lk Physical 
Sectors . 

DPB-1 - Physical Tracks per Side. Byte. 

This byte contains the number of Physical Tracks per Side, also called the 
Number of Cylinders. It reflects the Disk, as opposed to the Drive capabili- 
ties and is used to establish the requirements for double-stepping of Floppy 

Drives. In the case of a 40-track disk placed in an 80-track drive, this byte 

would contain 40. while the Drive parameter in the Configuration Section 
contains 80 as the number of tracks on the drive. This byte has no meaning 

for Hard Drive partitions or RAM drives and shouid be set to Zero, although 

any arbitrary value is acceptable. 
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DPB+O/1 - Logical Sectors per Track. Word. 

This value is the number oi Logicai 128-byte sectors on each data track oi the 
disk. It is equivalent to the number of Physical Sectors times the Physical 
Sector Size MOD 128. 


DPB+2 - Block Shift Factor. Byte. 

DPB+3 - Block Mask. Byte. 

DPB+4 - Extent Mask. Byte. 

These three bytes contain values used by the Operating System to compute 
Tracks and Sectors lor accessing logical drives. Their values are detailed in 
various references on CP/M and ZSDOS programming and should not be varied 
without knowledge of their effects. 


DPB+5/6 - Disk Size (Capacity). Word. 

This Word contains the number of the last allocation block on the drive. It 

is the same as the capacity in allocation blocks - 1. For example, il 4k 
allocation blocks are being used and a 10 Megabyte drive is being defined, 
this word would contain i 0.000. 000/4000 - 1 or 2499. 


DPB+7/8 - Maximum Directory Entry. Word. 

This Word contains the number of the last Directory Entry and is the same as 
the Number oi Entries - 1. For example, if 1024 directories are desired, this 
word would be set to U.i24 - ! = 1023. 


DPB+9/10 - Allocations 0 and 1. 2 Bytes. 

These two Bytes hold the initial allocations stored in the first two bytes ol 
the ALV Buffer (See 5.2.2. DPH+14/15 j during mitn. drive selection. Their 
primarv use is to indicate that the Directory Sectors are already allocated 
and unavai I able tor data storage. They are bit-mapped values and are used in 
Hi -byte. Lo-byte form as opposed to the normally used Lo-byte, Hi -byte storage 
used in Z80 type CPUs for Worn storage. The bits are allocated from the MSB 
of the first byte thru the LSD. then MSB thru LSb of the second byte based on 
one bit per allocation block or fraction thereof used by the Directory. The 
bits may be calculated by first computing the number of entries per allocation 
block, then dividing the desired number of entries by this number. Any re- 
mainder requires an additional allocation bit. 

For example, if 4k allocation blocks are used, each block is capable oi 
4096/32 bytes per entry = 128 Directory Entries. If 512 entries are desired, 
then 512/128 = 4 allocation blocks are needed which dictates that Allocation 
byte 0 would be illlOUOOB (0F0H) and Allocation Byte 1 would be OOOOOOOOB. 

DPB+11/12 - Check Size. Word. 

This Word is only used in - removable media (normally only Floppy Drives) ant 
indicates the numDer of sectors on w'hich to compute checksums to detect 
changed disks. it should be set to 0000H for Fixed and RAM Disks to avoid the 
time penalty of relogging after each warm boot. 

DPB+13/14 - Track Offset. Word. 

This Word indicates the number of Logical Tracks to skip before the present 
DPT i s effective. It is normally used to reserve boot tracks (usually 1 to 
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3), or to partition larger drives into smaller logical units by skipping 
tracks used for other drive definitions. 


5.3.1 Environment Descriptor. 

The Environment Descriptor, referred to as simply the ENV. is the heart of 
what is now known as The Z-System. The most recent additions to the system by 
Joe Wright and Jay Sage replaced some relatively meaningless elements in the 
ENV with system dependent information such as the location of the Operating 
System components. Consequently, the ENV is not just a feature of the ZCPR 
3.4 Command Processor Replacement, but is an Operating System Resource which 
ai low's other programs such as ZCPR 3.4 to access its information. 

The B/P Bios requires an ENV to be present, and uses several items of informa- 
tion contained in it. The banked ZSDOS2 and Z40 Command Processor Replacement 
use even more EN\ features. A few remaining bytes have been re-defined for 
support to B/P Bios-based systems. To denote the definition of B/P Bios data 
elements, a new Tyne. 90H. has been reserved. Using this "Type" byte, user 
programs can access and take advantage of the new definitions and features. 

A template for the Environment Descriptor used in B/P Bios which takes its 
values from the Z3BASF- .Lib file included in the distribution disk is: 

* * # * * * * * * * * -r * * * 4* X -i & * * ( ‘ {'■ ’I ] O N * * * * * X * * * * * x * S: * * * >: * m * x 

* If transitioning from an o I tier operating environment which * 

* uses usei -loaded Environment files such as SYS . ENT . you must * 

* either delete sue 1 " load instruction? or modify the ENV files * 

* to relied, the EXACT loaded system definition. * 

* Failure to observe this fact w.i i i probably cause many * 

* undes i red side effects! * 

* * * * % X * * * * *• & * j»; X 1 * >;• t- * * >.'■ * >'■ >. $ * >.'■ * * > * * X -Y- ********** * * * * X- * * * * * * * * >: * * * >.' 

; Environment Descriptor for ZCPRZ4 


J r 

0 

, Leading lump (address is CBIOS when NZCOM) 

DEFB 

■ Z3ENV ’ 

, Environment ID 

DEFE 

9 OH 

; Env type (> = 90H means E/P Extended ENV w/User Area) 

DEFW 

EXPATH 

; External path (PATH) 

DEFE 

EXPATHS 


DEFW 

RCP 

; Resident command package (RCP) 

DEFE 

RCPS 


DEFW 

I OP 

; Input/output package (IOP) 

DEFE 

IOPS 


DEFW 

FCP 

: Flew command package (FCP) 

DEFE 

FCPS 


DEFW 

Z3NDIR 

; Named directories (NDR) 

DEFE 

Z3NDIRS 


DEFW 

Z3CL 

: Command line (CL) 

DEFE 

Z3CLS 


DEFW 

Z3EMV 

; Environment (ENV) - Actual Starting Address 

DEFE. 

Z3ENVS 




